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i em 1995, quando Rasmus Lerdorferiou para 


ye /FOrms 


Interpreten, Porém, ele não imaginava que estava criando uma das mais pode- 


rosas linguagens para O desenvolvimento de aplicações na Web. O PHP (s 


que hoje é um acrônimo recursivo para PHP: Hypertext Preprocessor) con 


quistou muito 5 nos úlimos anos. Isso se deve principalmente à facilida- 


l 
de de utilizaçã 


diversidade de recursos que pe 


aguagem totalmente voltada à internet, possibilitando o desen 


es realmente dinâmicos. Dominando essa linguagem, pode- 


SO Lia 


mar aqueles sites estáticos, feitos de HTML puro, em sites interati- 


vos, utilizando todas as técnicas de programação que essa linguagem oferece. 


ocê vai api 


nder os conceitos de programaç 


‘e tratar as informações enviadas por eles, como criar seu 


-xecutar comandos SQL para acessá-lo mediante seus pro- 


e muito mais. 


O livro apresenta ainda uma explicação detalhada sobre a linguagem PHP e 


5 suas é 


acterísticas, além de noções de programação, sintaxe e estru- 


ode programas, manipulação de dados, entre outros assuntos, NAO im- 


yria se você é iniciante ou se já é um usuário mais experiente. Esta obra será 


muito útil para ajudar você a dominar e criar excelentes sites com o PHP, 


Durante à leitura podem-se encontrar diversas dicas do autor, e também pro- 
grimas-exemplo desenvolvidos por ele para facilitar o aprendizado da lingua- 
gem. 


Todos os exemplos de programas apresentados neste Hyro estão 
disponíveis para download no site da Novatec Editora, no endereço 
t 


ntp: 


ur novateceditora.com.br/download/php. 
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Quem deve ler este livro 


Este livro destina-se a pessoas que querem aprender a desenvolver páginas 
dinâmicas na Web utilizando o PHP, Como pré-requisito para poder compre- 
ender os conteúdos apresentados, é importante que o leitor tenha um conhe- 
cimento razoável sobre HTML, a linguagem padrão para a criação de páginas 
na Internet. 


Esse conhecimento é importante porque o PHP funciona em conjunto com a 
HTML isto é, o código PHP é embutido no meio de uma página HTML, Portan- 
to, se você não tem nenhum conhecimento sobre essa linguagem, é recomen- 
dávela leitura de algum material (apostila, livro, site etc.) sobre o assunto, Isso 
não deve lhe tomar muito tempo, visto que a HTML é uma linguagem de mar- 
cação bastante simples. 


Os assuntos abordados neste livro são úteis tanto para usuários iniciantes como 
para os mais experientes, pois abrangem desde noções básicas de programa- 
ção até conteúdos mais avançados como a criação e manutenção de bancos 
de dados, manipulação de cookies, gerenciamento de sessões, operações so- 
bre arquivos, envio de e-mails, entre outros, 


A metodologia de ensino utilizada aqui será a mesma das demais obras do 
autor, onde a didática é o ponto forte, A abordagem dos temas é clara, objetiva 
e as explicações são feitas passo a passo para facilitar o aprendizado. 


Como este livro está organizado 


O livro é composto por quinze capítulos e por quatro apêndices, É recomen- 
dável ler os capítulos de forma sequencial, visto que muitos deles requerem o 
conhecimento de assuntos apresentados em capítulos anteriores. A seguir é 
apresentada uma rápida descrição dos conteúdos abordados. 


Capítulo 1 - O que é o PHP? explica o que é PHP, descreve as características 
da linguagem e apresenta situações nas quais é interessante o seu uso, 


Capítulo 2 - Instalação do PHP. explica como obter a versão mais atual da 
linguagem e quais são os softwares necessários para colocá-la em funciona- 
mento, 


Capítulo 3 - Noções básicas de programação: mostra como você pode come- 
çar a programar, além de apresentar a estrutura básica de um programa PHP e 
como embutir código PHP em uma página HTML. 


Introdução o 


Capítulo 4 - Manipulando os dados em PHP: apresenta os tipos de dados exis- 
tentes no PHP, além de ensinar à utilizar constantes € variáveis. Mostra ainda 


os operadores que podem ser utilizados no PHP e a precedência entre « eles. 


7 Estruturas de controle € em PHP: « ensina à utilizar os comandos 
fore 


foreach), Mostra também como “controlar o fluxo dee execução a dos programas 


com as instruções break € continue. 


C apítulo € 6 - Funções e classes: ensina a criar funções no PHP, a presentando à 
sintaxe básica e mostrando como retornar valores com o comando return. 
Contém exemplos envolvendo validação de CPF e funções recursivas, além 


de ensinar a criar uma classe: AO Final, apresenta algumas caracter iste 


do 


novo modelo de objetos da versão 5 do PHP. 


Capítulo 7 - Utilizando includes em PHP; explica a utilidade das includes € 
mostra como criar um menu para o seu site utilizando esse recurso. Apresenta 
ainda um exemplo envolvendo a exibição da data atual e explica a diferença 
enire os comandos include e require. 


capo PHP e formulários HIML: mostra como você pode tornar seu site 
mais interativo com a criação de formulários HTML, através dos quais o usuá- 


de a 


rá enviar informações 


rio poc 


para os seus programas PHP, Ensina a tratar os 


dados recebidos por meio de formulários, além de aplicar funções especiais 


para formatação desses dados. 


Capítulo 9 - Passando informações por várias páginas: explica como pode ser 
feita a o issagem de informações entre diversas páginas PHP, tanto através do 


campo hiddente seondido) dos formulários HTML, como t ambém pelas URLs, 
Utilizan 


ses conceitos, apresenta um exemplo de divisi 
de usuários em väri 


jo do cadastramento 


as etapas. 


Capítulo 10 - PHP e variáveis de ambiente: explica o que são variáveis de 
ambiente e mostra como obter o valor dessas variáveis dentro de um progra- 


ma PHP, Contém ainda a lista das principais variáveis de ambiente. 


Capítulo 11 - Banco de dados: MySQL ou PostgreSQL: ensina a criar bancos 
de dados e tabelas nos SGBDs (Sistemas de Gerência de Bancos de Dados) 
My sé yi 


e PostgreSQL, além de apresentar os comandos SQL para realizar ope- 


E es Ta ao ipei < 
s (consultas, incluso 


g 


raço 


alterações e exclusões) em cada um deles. 


Capítulo 12 - PHP com banco de dados: ensina a utilizar o PHP para conectar 
se a um banco de dados e executar comandos SQL sobre ele. Mostra também 
como utilizar as funções do MySQL e PostreSQL para obter os dados resultan- 
tes de uma consulta e dar a eles um tratamento adequado. 


Capítulo 13 - Cookies e sessões: ensina a utilizar esses recursos para manter 
informações através de acessos subsequentes. Mostra como realizar a autenti- 
cação de usuários e ensina a criar um sistema de username password (usuá- 
rio/senha) para o seu site. 


Capítulo 14 - Manipulando arquivos em PHP: explica em que situações é re- 
comendável o uso de arquivos, além de apresentar as funções do PHP respon- 
sáveis pelas operações mais comuns (abertura, fechamento, leitura e escrita) 
sobre eles. 


Capítulo 15 ~ Enviando e-mails com o PHP: explica a utilidade do envio de e- 
mails através de uma página Web e apresenta a função mail, responsável por 
executar essa tarefa no PHP, Mostra ainda como adicionar informações ao ca- 
beçalho do e-mail e apresenta a lista dos principais cabeçalhos (mail headers) 
existentes, 


Apêndice A - Comandos gerais do PHP. apresenta a descrição dos principais 
comandos do PHP, Pode ser utilizado como referência. Os comandos foram 
divididos em diversas categorias, como arrays, strings, variáveis, funções, clas- 
ses e objetos, matemática, data e hora, sistema de arquivos (filesystem), dire- 
tórios, HTTP, FTP, URL, imagens, entre outras. 


Apêndice B - Funções PHP/bancos de dados: apresenta uma lista de funções 
do PHP que podem ser utilizadas para realizar a integração com diversos SGB- 
Ds, como MySQL, PostgreSQL, InterBase, Oracle, SQL Server etc. 


Apêndice € - Tipos de recursos do PHP; apresenta uma lista de funções que 
criam e finalizam os diversos recursos oferecidos pelo PHP, 


Apêndice D - Links interessantes: indica diversos links para você se aprofun- 
dar ainda mais no estudo da linguagem PHP e de outras tecnologias, Os sites 
recomendados oferecem diversas ferramentas úteis para o desenvolvimento 
de sites dinâmicos e interativos, como tutoriais, scripts gratuitos e documenta- 
ção detalhada. 


O PHP é uma das linguagens mais utilizadas na Web. Hoje mais de 10 milhões 
de sites no mundo inteiro utilizam PHP. A principal diferença em telas 
outras linguagens é a či -apacidade que o PHP tem de interagir com o imundo 
web, transformando totalmente os websites que possuem páginas estáticas. 


imagine, por exemplo, um website que deseja exibir notícias em sua pá g 
principal, mc 


tando a cada dia, ou a cada hora, notícias diferentes. Sena 


avel fazer isso utilizando apenas HTML, As páginas seriam estáticas, € a cada 


notícia nova que aparecesse no site a página deveria ser alterada manualmen 
s enviada ao servidor por FTP Ge 1 Transfer Protocol) para que 


PAS 


te, e logo apé 


sssem mostradas no site. Com o PHP tudo isso poderia ser 
feito automaticamente: Bastaria criar um banco de dados onde ficariam arma- 
senadas as noticias; e criar uma página que mostra essas notícias 


puxata Jo- 


as” do banco de dados. 


ABC 


PRS 


a imagine um site que possui cerca de 100 páginas. Suponha que no lado 


€ E das páginas há um menu com links para as seções do site. 5 alguma 
à for incluída ou excluida, o que você faria para atualizar as 100 pi 


incluindo ou excluindo esse novo tink? Alteraria uma a uma, manualmente? 


Com certeza você demoraria horas para alterar todas as páginas. E isso deveria 
ser feito cada vez gue houvesse alteração, inclusão ou exclusão de uma se 
no site. 


Para resolver esse problema utilizando PHP é muito simples. Basta construir 
um único menu, e fazer todas as 100 páginas acessarem € esse arquivo e mosto 

lo em sua parte da esquerda. Q juando alguma alteração fosse necessária, basta- 
riaalterar um único arquivo, e as 100 páginas seriam alteradas automaticamen- 
te; já que todas acessam O mesmo menu, 


ssas são apenas algumas das inúmeras vantagens das páginas que u utilizam 


abou de conhecer dois exemplos de sites em que à principal 


característica é o dinamismo e a praticidade, Automatização de tarefas, econo- 
mia de tempo e de mão-de-obra são características evidentes nos dois exem- 
plos citados. Mais adiante veremos como implementar programas como os 
que foram citados aqui. 


Características do PHP 


Gratuito e com código aberto 


Uma das grandes vantagens do PHP é que ele é gratuito. O arquivo de instala- 
ção pode ser obtido gratuitamente no site http://ww.php.net, Este livro está 
baseado na documentação da versão 5 do PHP, pois esta versão oferece al- 
guns recursos adicionais em relação às anteriores, como por exemplo o su- 
porte à ferramenta SQLite (que veremos no capítulo 11). O PHP 5 apresenta 
ainda um desempenho superior às versões anteriores, principalmente no que 
diz respeito à programação orientada a objetos, que agora funciona de forma 
mais eficiente, não realizando cópias redundantes de dados. 


No site oficial do PHP você encontrará sempre as versões mais atuais disponí- 
veis para download, assim como as versões anteriores. A maioria dos concei- 
tos e programas apresentados neste livro vale tanto para a versão 4 quanto 
para a versão 5 do PHP, porém é recomendável que você obtenha sempre a 
versão mais recente da linguagem, para poder aproveitar os novos recursos e 
instalar as correções para os defeitos (bugs) encontrados pelos desenvolvedo- 
res nas versões antigas. 


Outra característica importante do PHP é que, além de ser gratuito, é um sof- 
tware com código-fonte aberto. O código-fonte do PHP assim como sua docu- 
mentação detalhada também estão disponíveis no site oficial. 


Embutido no HTML 


Outra característica do PHP é que ele é embutido no HTML. Veremos mals 
adiante as facilidades que isso pode nos trazer, Uma página que contém pro- 
gramação PHP normalmente possui extensão .php (isso depende da configu- 
ração do seu servidor Web). Sempre que o servidor Web receber solicitações 
de páginas que possuem essa extensão, ele saberá que essa página possui 
linhas de programação. Porém, você verá que o HTML e o PHP estão mistura- 
dos, pois começa a escrever em PHP, de repente escreve um trecho em HTML, 
depois volta para o PHP, e assim por diante. 
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Há um exemplo simples para facilitar a compreensão: você já deve ter visto 
alguns sites que exibem a data e hora atual em suas páginas. Se essas informa- 
ções forem escritas utilizando JavaScript, a data e hora mostradas serão retira- 
das do relógio do seu computador, Ou seja, para cada pessoa que acessar, à 
data e hora mostradas serão diferentes, pois nem todos os computadores mar- 
cam exatamente o mesmo horário, Agora, se a data e hora forem escritas utili- 
zando PHP, essas informações serão retiradas do relógio do servidor, ou seja, 
há um relógio único, e por isso todos que acessarem o site ao mesmo tempo 
verão a mesma data e hora. 


Bancos de dados 


Diversos bancos de dados são suportados pelo PHP, ou seja, o PHP possui 
código que executa funções de cada um. Entre eles temos MySQL, Postgres- 
QL; Sybase, Oracle, SQL Server e muitos outros. Cada um dos bancos de dados 
suportados pelo PHP possui uma série de funções que você poderá usar em 
seus programas para aproveitar todos os recursos. Os bancos de dados não 
suportados diretamente pelo PHP podem ser acessados via ODBC. Neste livro 
veremos exemplos de utilização do PostgreSQL e do MySQL, mas você poderá 
programar utilizando qualquer outro banco de dados, para isso basta fazer a 
adaptação dos comandos referentes a ele. Comandos utilizados por outros 
bancos de dados são encontrados na documentação do PHP, disponível para 
download no site oficial. 


Portabilidade 


Podemos executar o PHP no Linux, Unix ou Windows NT, Vamos falar mais 
sobre a utilização do PHP no Linux, embora haja poucas diferenças em relação 
aos demais sistemas operacionais. 


Instalação do PHP 


«cessário em termos de hardware e software an 


de você comecar a escrever seus programas em PHP, Este livro não se destina 


ss detalhadas sobre instalações de softwares, no entanto este 


a dar explicaç 


tem esclarecerá muitas de suas dúvidas quanto aos recursos necessários para 


utilização do PHP. Vamos analisar cada caso. 


Utilizando um provedor de hospedagem 


prender a utilizar a programação PHP e des 


gem, sem ficar se preocupando con 
s provedores aqui no país, e vo 
procurar em qualquer site de busca, Alguns deles oferecem bons serviç 


preços bem acessíveis, que varam mais ou menos de R$5,00 a R$39,90 por 


espaço (em MB) e dos recursos fornecidos. Esses prove- 


todas as ferramentas de bancos de dados ne 


ssárias. Alguns provedores de 


hospedagem cf m suporte a PHP com banco de dados MySQL e outros 


ofe 


em o PostgreSQL. Essa é uma boa solução para quem quer criar seu ste 


de forma rápida e eficiente, pois os provedores de hospedagem lhe fornecem 


uma conta de FTP (File Transfer Protocol, que você utilizará para enviar suas 


áginas 20 servidor, yrmente acessá-las pela Web, sem precisar fazer 


e poster 


nenhuma configuração de sofiwares e servidores. 


Instalando a partir de uma distribuição Linux 


Se você tem um bom equipamento (hardware), e quiser montar set p 


ários, uma boa alternativa é 


servidor para instalar nele os softwares neces 
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talar Os sistemas operacionais que já acompanham tôdos Os pacotes necessári- 
os, incluindo linguagens de programação, compiladores, servidor Web, banco 
de dados etc. Um exemplo que pode ser citado é o do Linux, em suas diversas 
versões. As distribuições mais atuais do Linux apresentam um programa de 
instalação bastante amigável, em que você pode escolher os pacotes que de- 
seja instalar, e o programa de instalação faz tudo para você, Para utilizar o PHP 
você terá de selecionar os seguintes pacotes para instalação: 


* PHP: a linguagem de programação. 


* Apache: é o servidor Web. O Apache é o servidor Web mais indicado, pois 
o PHP roda como um módulo nativo dele. 


* MySQL ou PostgreSQL: gerenciador de banco de dados, Selecione aquele 
que acompanha a distribuição Linux que você estiver instalando. 


É importante lembrar que o PHP é uma linguagem voltada para a Web, portan- 
to deve haver um servidor Web, que receba as solicitações das páginas, faça O 
processamento pelo PHP, e retorne ao browser um resultado, 


Instalando manualmente no Linux ou Windows 


Se você quiser instalar o PHP manualmente, ele está disponível para download 
no site oficial, no endereço: 


http://www php.ner/ 


Acessando a seção “downloads”, você poderá obter sempre a última versão 
da linguagem. Na versão para Linux, o PHP precisará ser compilado em seu 
sistema operacional, Para obter mais detalhes, consulte o arquivo install txt que 
acompanha a distribuição, Na versão Windows, a distribuição está disponível 
em um arquivo compactado ZIP, que já contém os arquivos binários. Basta 
descompactá-lo em algum diretório do seu computador. 


Para poder acessar seus programas pelo navegador, você precisará também de 
um servidor Web. O mais indicado é o Apache, que pode ser obtido em: 


http://hitpd apache org/ 


O arquivo install txt, que acompanha o PHP, contém as instruções para a con- 
tiguração do PHP no Apache, Se você pretende trabalhar com banco de dados, 
duas opções interessantes são O MySQL e o PostgreSQL. que podem ser obtidos 
respectivamente em http//www.mysqlcom e hip://w ww postgresglorg. 

Se você tiver dificuldades de instalar o PHP no Windows, pode consultar 
o roteiro de instalação disponibilizado no site pessoal do autor, em http:// 
www niederauvercom br/livros/phpyroteiro html. 


Noções básicas de programação 


Você que está iniciando agora no mundo da programação deve prestar Das- 
tante atenção nos próximos tópicos, pois vamos falar de conceitos 


de progra 


E são 
mação e suas implementações, utilizando o PHP, Mesmo que você já tenha 


certa experiência em programação, leia os próximos tópicos para ir se accosti- 


mando com a sintaxe do PHP. 


Começando a programar 


Bom, vamos ao que interessa: a parte prática, Agora começaremos a escrever 


programas em PHP. Abra qualquer editor de textos que você tiver (pode ser o 
Bloco de Notas do Windows, ou o VI do Linus). No próximo item veremos 
como é estruturado um programa em PHP, e você entenderá um pouco me- 
ihor Agora digite as seguintes linhas em seu editor: 
<html> 
<body> 
«?php 

ff Legal, estou escrevendo meu primeiro programa em PHP 

echo “<h? aligna'center'>parabéns para mimie/h2»" 


Poe 


</body> 


«/himi> 


Salve esse programa como progl.php e envie para o diretório que você estã 
utilizando para hospedar o site. Seu primeiro programa vai gerar como resulta- 
do a frase “Parabéns para mim!” centralizada na página. Para ver o resultado, 
basta você ace 


sar pelo browser o endereço hitp://<seu endereço>/progi php, 
onde você deve substituir «seu endereço» pelo endereço do servidor que está 
utilizando para rodar os programas PHP, 
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Figura 3.1 — Resultado do seu primeiro programa. 


Fácil, não? A seguir veremos com detalhes o que significa cada uma das linhas 
que você digitou nesse programa. 


Todo o trecho de programação PHP deve estar entre as tags </php e >, para 
que o servidor Web saiba que esse trecho deve ser processado. Vejamos então 
cada elemento do programa progi.php: 


Elemento Descrição 


<?php informa que aqui começa um programa PHP. 


li Representam uma linha de comentário. Tudo que vem após estas barras na 
mesma linha é ignorado pelo PHP, Os comentários são muito úteis para uma 
boa documentação do seu programa, As duas barras servem paratransformar 
uma única linha em comentário, mas você pode usar o /* par iniciar uma 
sequência de comentários, e depois finalizar os comentários com o Y. 


echo É um dos comandos mais utilizados em PHP. Serve para escrever alguma 
coisa na tela, 
?> Informa que aqui termina q programa PHP, 


Se você escolher a opção Exibir-Código-fonte em seu browser, você verá O 
código que seu browser recebeu, que foi o seguinte: 

<html> 

<body> 

<h? align='center'>Parabéns para mimi</h2> 

</body> 

«/himi> 
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pro 


Note que o browser não recebe nenhuma linha em PHP, somente recebe cô- 
digo HTML puro, pois, como já vimos, o PHP roda no servidor, Toda a progra- 


mação PHP é proce: ada no servidor, que retorna somente O resultado final 


para seu browser, 


Dica: quando as páginas possuem extensão html, o servidor Web as tratará como HTML puro, e 
não reconhecerá códigos PHP, Se a página possuir extensão php, o servidor Web ativará O 
processador de hipertexto do PHP para verificar linha a linha em busca de códigos de programação, 
por isso o processo fica um pouco mais lento. A dica é a seguinte: só coloque extensão „php nas 
páginas que realmente possuem códigos PHP, senão você estará gastando um tempo 
desnecessário, procurando a cada linha códi ue não existem na página... 


Em relação à velocidade de processamento, podemos fazer uma pequena ce 
paração entre o PHP e a linguagem ASP (Active Server Pages), da Microsoft 


Mesmo que as páginas php demorem um pouco mais para serem proce 


jo que as páginas com HTML puro, elas são processadas muito mais rápido 


que aquelas que usam programação ASP, Diversos testes realizados por pro- 


gramadores americanos já comprovaram isso, Além disso, o PHP possuí um 


gerenciamento de memória muto superior ao do ASP, 


Estrutura de um programa PHP 


Código PHP e comandos HTML 


Os comandos HTML devem aparecer fora das tags <?php e ?>, pois estas limi- 
tam um trecho de programa PHP. Dentro dessas tags até podem aparecer cO 
mandos HTML, mas somente se utilizarmos O comando echo para escrevê-los. 


Você pode ir concatenando : 


ipts PHP com comandos HTML, podendo des- 
sa forma, escrever vários scripts PHP em uma única página, Cada script PHP 
existente na página deve começar com a tag <?php, e terminar com ?> Às li- 
nhas de programação que serão escritas entre as tags devem sempre terminar 
com ; (ponto-e-vírgula), senão ocorrerão erros no momento da execução da 
página, Entre essas tags você pode escrever programas, utilizando todos os 
recursos que o PHP lhe oferece, como definição e chamada de funções, aces- 
coa banco de dados, atribuição de valores a variáveis, fórmulas matemáticas etc. 


Toda essa mistura entre o HIML e o PHP é muito útil, pois nós utilizamos O 
PHP para gerar os dados dinamicamente, enquanto O HTML é usado para for- 
matar e exibir esses dados nas páginas mostradas no browser. 


Vamos ver um exemplo que mistura HTML e PHP para mostrar a data atual. 
Digite o seguinte programa em seu editor de textos, e salve-o como prog2. php: 


«html> 
«body> 
<?php 
fdata de hoje = date ("d/m/v" timeO): 
?> 
<p aligna“center">Hoje é dia <?php echo Sdata de.hoje; ?></p> 
</body> ` 
</html> 


Perceba a combinação existente entre os comandos HTML e o código PHP. No 
início do programa atribuímos à variável $data de. hoje a data atual, utilizando 
o comando date. Essa variável estará disponível para uso em qualquer parte da 
página. Depois utilizamos comandos HTML para escrever “Hoje é dia”, e com- 
pletamos abrindo um novo trecho de PHP, escrevendo a data atual armazena- 
da na variável $data de hoje por meio do comando echo, 


Exibindo a página no browser 


Para o browser mostrar alguma coisa na tela é necessário que a página tenha 
pelo menos um comando echo para escrever algo, ou então comandos HTML 
que escrevam o conteúdo da página. Porém, somente se for usado o comando 
echo ou algum outro comando PHP que produza uma saída na tela, você real- 
mente terá informações dinâmicas, pois o HTML é estático, imprime sempre as 
mesmas informações na tela. 


Veja o seguinte exemplo: 


<html> 

<body> 

<?php 
fdia = date (d/m/v" time O); 
fbase = 5,5; 
$aitura = 10; 


$area = $base * Saltura; 
?> 
</body> 


</html> 
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Salve esse programa como prog3.php, e veja o resultado em seu navegador. 
Perceba que não há nenhum comando echo no programa, por isso seu nave- 
gador mostrará uma tela em branco, O que ocorreu foi que os valores atribui- 
dos às variáveis ficaram armazenados apenas na memória, mas não foram 
mostrados na tela. Ao visualizar o código-fonte recebido pelo navegador, você 
ve 


rá apenas as tags do HTML: 
<html> 

<body> 

</body> 


</htmi> 


Vejamos agora um exemplo parecido com o anterior, mas dessa vez vamos 
utilizar o comando echo para mostrar informações na tela, Digite o seguinte 
programa em seu editor de textos e salve-o como progá php. 
<html> 
<body> 
<?php 
$time = “Grêmio”: 
fano = 1983; 
frasel = “O $time é o melhor clube de futebol do mundol”; 
frase? = “O $time foi campeão do mundo em fano”; 
echo “«h3>$frasele/h3>"; 
echo “«h3>Sfrased</h3»"; 
?> 
</body> 
</html> 


Abrindo essa página em seu browser, você obterá o seguinte resultado: 


Dasenvaleanda Webas com PHP - Micincoil a ae a 


hip: žocabost/eioghpřnogi. pho 


O Grêmio é o melhor clube de futebol do mundo! 


| O Grêmio foi campeão do mundo em 1983 


Figura 3.2 — Resultado gerado pelo programa prog4.php. 
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Com esses exemplos você descobriu dois dados fundamentais: 


1) a importância do comando echo: para gerar dados dinâmicos é fundamen- 
tal dominar esse comando. 


2) ainterpolação de variáveis: daqui em diante você vai usar muito essa técni- 
ca. Trata-se da inclusão do valor de uma variável dentro da outra, como, 
por exemplo, em nosso programa prog4.php, em que na variável chamada 
$frasel incluímos o valor da variável $time, e na variável $frase2 incluímos 
o valor da variável $time, e também da variável $ano. Ou seja, dentro da 
string que é atribuída a uma variável podemos colocar outra variável, e na 
hora do processamento do programa o PHP substituirá a variável pelo seu 
valor, 


Lembrando que em PHP as variáveis começam sempre pelo símbolo de cifrão 
($). Quando houver um cifrão diante de um nome qualquer, o PHP interpreta- 
rá isso como uma variável. 
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importantes para você dominar a siniaxe da lingua- 


1, pois agora veremos como devem ser tratados valores numéricos, strings, 


artays (vetores), constantes, valores obtidos por meio de formulários etc. Ve- 


> 


remos também como < ma. 


tiar dinamicamente novas variáveis em seu pros 


outras linguagens, como, por exemplo, a linguagem ©, no 


=ssário fazer declaração de variáveis, basta fazer-lhe diretamen- 


te a atribu ode um valor 


Dados numéricos 


São números inteiros, reais, positivos, decimais, octais e bexadecimais. Os da- 


dos numéricos são utilizados geralmente para efetuar cálculos, I 


tar números muito pequenos ou muito grandes, pode-se usar a notação cien 


que 


ifea. Por exemplo: 1,500.000.000 pode ser expresso como L5E+9, 


Veia alguns exemplos de dados numéricos: 


Dados Descrição 

5 Vai eiro na base decimal, 

ao Valor real (ou ponto flutuante) com três casas decimais, 

tá Valorreal com duas casas decimais. E o mesmo que 0.14. Quando o número 
começa com um ponto o O é considerado como algarismo inicial. 

= 038 Valor inteiro na base octal. Todo valor Iniciado com O é tratado como base 

& {na base 8 são utilizados apenas os algarismos 0,1,2,3,4,5,6 8 4. 

xo Valor inteiro na base hexadecimal. Todo valor iniciado com Ox é tratado 
como base 16 (na base 15 são utilizados os 10 algarismos do sistema 
decimal e mais as letras ABCD E e F, que representam os valores de 10 
ais. 

43000000 É um número real grande, gue pode ser expresso utilizando a notação 


científica: 4.3E+7. 
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Dados alfanuméricos (textos) 


Também conhecidos como strings. São sequências de caracteres, que podem 
ser delimitadas por aspas simples (, aspas duplas (©) ou aspas invertidas C), 
dependendo da utilização desejada. O PHP tata os dados alfanuméricos de 
forma diferente de acordo com o delimitador utilizado. Vamos acompanhar 
exemplos envolvendo cada um dos delimitadores, e verificar as diferenças entre 
os três tipos: 


Aspas simples () 


As aspas simples são muito parecidas com as aspas duplas, mas existem pe- 
quenas diferenças entre elas. Esse tipo de aspas pode ser usada para delimitar 
qualquer dado alfanumérico (sequência de caracteres), como por exemplo: 


tep align=center>Texto utilizando aspas simples</p>' 


Porém devemos tomar cuidado com textos que possuem o caractere “em sua 
sequência de caracteres, como, por exemplo, o seguinte: 


“welcome to the John's Page’ 


Como existe uma aspa simples no meio da sequência de caracteres, o PHP vai 
interpretá-la como delimitador de finalização do texto, e isso causará um erro 
de execução. Esse problema pode ser facilmente resolvido, inserindo antes da 
aspa o caractere de controle \ (barra invertida), que indica ao PHP que aquela 
aspa deve ser tratada como um texto comum, € não como um delimitador., 


O caractere de controle A) também é bastante usado quando utilizamos aspas 
duplas e queremos incluir o símbolo $ dentro de um dado alfanumérico. Sabe- 
mos que se colocarmos o símbolo $ sem a barra invertida antes, o PHP inter- 
pretará isso como uma variável, e procurará o valor dela para inserir. Se quiser- 
mos que apareça o símbolo $, bastã escrever \$ dentro da sequência de carac- 
teres. 


Lembre-se de que no momento da exibição na tela não será mostrado o carac- 
tere \, somente a sequência de caracteres, pois o caractere \ apenas indica ao 
PHP que o caractere faz parte da sequência. 


Você já deve ter visto em outras linguagens que para gerar uma quebra de 
linha em algum texto devemos inserir o caractere \n. Isso não é necessário 
quando utilizamos as aspas simples como delimitador. Se quisermos inserir 
uma quebra de linha em um texto com aspas simples, basta dar um ENTER no 
meio do texto, e você verá o resultado na saída do programa, conforme mostra 
o exemplo a seguir: 


Jos em PHP 33 


Ee 


echo ‘<p align=center>Isto é um teste 

Estou aprendendo à escrever textos com aspas simplesi</p>': 
Pa 
</body> 


<html> 


Ive esse programa como prog5. php. É importante deixar bem claro que as 


guel 


was de linha existentes no meio do texto serão apresentadas apenas se à 
saída do programa for em formato texto, ou seja, no formato HTML você não 


verá nenhuma quebra de linha ao executar a página progs, php, conforme 
mostrado na figura 4.1: 


a EE 


http! /localhost/iviophp/ progs php 


q 


Figura 4.1 — Resultado gerado pelo programa prog5.php. 


z3 


voc pedir pára visualizar o código-fonte que o browser recebeu será pos- 
sivel ver o seguinte resultado: 


<p align=center>Isto é um teste 
Estou aprendendo a escrever textos com aspas simples! </p> 
</body> 


«freio 


Você pode notar que as quebras de linhas foram mostradas no código-fonte 
recebido, pois este está em formato texto. Se seu objetivo é apresentar quebras 
de linha no formato HTML, para que sejam mostradas na tela, deve-se usar a 
tag <bro do HTML. Logo a seguir temos um exemplo do comando echo em 
que são apresentadas as quebras de linhas no browser: 


echo “Isto é um teste"; 
echo “<br>; 


echo ‘Coloquei uma quebra de Vinha; 
O comando apresentado produzirá em seu navegador a frase Isto é um reste, € 


na linha de baixo a frase Coloquei uma quebra de linha. A tag <br> gerou uma 
nova linha na saída HTML. 


Aspas duplas (”) 


As aspas duplas são muito parecidas com as aspas simples. Uma diferença 
importante entre esses dois tipos de aspas é que, utilizando aspas duplas, po- 
demos fazer uma interpolação de variáveis. Como já vimos anteriormente, a 
interpolação de variáveis consiste em incluir o valor de uma variável dentro da 
outra; como mostra o trecho de programa a seguir: 


exemplo4. 1.php 


<?php 
Spalavra = “teste”; 
Sfrase = “Isto é um Spalavra”; 
echo Sfrase! 


7> 
O resültado gerado por esse programa será a frase Isto é um teste. 


Outra diferença entre as aspas simples e duplas é que, utilizando aspas duplas 
como delimitadores, podemos incluir seqüências de caracteres de controle 
nos dados alfanuméricos. A tabela a seguir mostra algumas seqüências de con- 
trole que podem ser inseridas quando utilizamos aspas duplas: 


Controle Significado 

E insere no texto o caractere ©7777 
\n Nova linha 

Y Retorno de carro (carriage return) 

M Tabulação 

\$ insere no texto o simbolo $ 

\ insere no texto o caractere \ 

\0nnn Caractere ASCII octal 


tn Caractere ASCI hexadecimal 
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disso, dentro de um dado alfanumérico delimitado por aspas duplas po- 


«mos inserir normalmente o caractere ' (aspas simples), como, por & 


amplo, 


no seguinte texto: 


“welcome to the John's page” 


utilizávamos aspas simples, tinhamos de colocar o caractere de con- 
le \ para não haver erros de execução nesse texto, mas agora com as aspas 
s É necessário, Porém, devemos tomar cuidado ao inserir o ca- 
raciere “ dentro de um texto. Veja o exemplo: 


“Estou colocando “aspas duplas” dentro de um texto” 


m como ocorreu com as aspas simples > texto anterior também apre 


rá problemas de execução, pois o PHP interpretará a segunda aspa como 


ador de finaliz 


> de texto. Para resolver esse problema, basta inserir 


o caractere de controle (ou caractere de escape) +, que indica ao PHP que 
aquelas aspas fazem parte do texto. O texto então ficaria da seguinte forma: 


“estou colocando “aspas duplas” dentro de um texto” 


Aspas invertidas () 


ç 


Utilizando aspas invertidas como delimitadores, estamos usando uma função 


inte que o PHP nos oferece: executar comandos do sistema ope- 


Je S 


je um programa PHP. Dessa forma podemos enviar ao li- 


alkquer outro sistema ope 


donal que você esteja uti~ 


lizando, comanc 


S para serem cxeciiac 


as por ele, Muitas vezes podemos exibir 


no browser o resultado gerado por comandos do sistema operacional. Pode- 
mos, por exemplo, vera lis 


agem de arquivos HTML existentes em determina- 
do diretório do Linux, como mostra o exemplo a seguir: 


exemplo4, 2.php 


«html> 


<body> 


E importante lembrar que você só cc 


guirá executar comandos do sistema 
operacional possuindo privilégios para executá-los, e isso depende de como 
o seu administrador configurou o sistema. Não será possível, por exemplo, ver 
o conteúdo de diretórios protegidos, aos quais você não tem acesso autorizado. 


Constantes 


São valores que são predefinidos no início do programa, e que não mudam ao 
longo de sua execução, Você pode definir suas próprias constantes utilizando 
o comando define, que possui a seguinte sintaxe: 


bool define (string nome, misto valor [, bool case. insensitivel) 


Onde “nome” é o nome que você vai utilizar para representar a constante, 
“valor” é um valor qualquer (numérico ou alfanumérico)a ser atribuído a ela e 
“case insensitive” é um valor lógico (true ou false) que indica se o PHP deve 
diferenciar letras maiúsculas e minúsculas quando houver uma referência a 
essa constante. Veja o exemplo a seguir, que mostra como devemos usar as 
constantes: 


& exemplo4 3.php 


<html> 
«body> 
<?php 


define ("meunome”, "Juliano"; 


define (“peso”,78); 


echo “O meu nome é ” . meunome: 

echo “<br>”: 

echo “O meu peso é ” . peso. “ quilos”; 
?> 
</body> 
</html> 


Executando esse programa, você terá o seguinte resultado em seu navegador: 
O meu nome é Juliano 


O meu peso é 78 quilos 


Note que no exemplo que acabamos de ver, referenciamos as constantes dire- 
tamente pelo nome que escolhemos, e não utilizamos na frente delas o simbo- 
lo $, pois esse símbolo é utilizado apenas para representar variáveis, 


Outro recurso que utilizamos no exemplo foi a concatenação, representada 
pelo ponto (.). Podemos concatenar quantos dados quisermos, e todos eles 
serão exibidos como apenas uma segiiência de caracteres. 


Além de você poder definir suas próprias constantes, o PHP já possui diversas 
constantes próprias predefinidas, Vamos conhecer algumas na tabela a seguir: 
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Constante Descrição 

TRUE — vala verdadeiro (utilizado para comparação). 

FALSE Valor falso. 

MEO Contém o nome do script que está sendo executado, 

ANNE Contém o número da linha do scripí que está sendo executado 
PHP VERSION Contém a versão corrente do PHP, 

PHP. OS Nome do sistema operacional no qual o PHP está rodando. 

E ERROR Exibe um erro ocorrido em um script. À execução é interrompida. 
E WARNING Exibe uma mensagem de aviso do PHP. A execução não pára. 
E PARSE Exibe um erro de sintaxe. À execução é interrompida. 

E NOTICE Mostra que ocorreu algo, mas não necessariamente um erro, A execução 


não pára. 


Variáveis em PHP 


As variáveis servem para armazenar dados que podem ser usados em qual 


quer ponto do programa, Cada variável está associada a uma posição de me- 


mória de seu computador, Ao contrário de linguagens tradicionais, como C, 


Pascal e Delphi, no PHP não é necessário fazer declaração de variaveis. Basta 


atribuir diretamente um valor a ela e a partir desse momento tá está criada e 


associada 


e), dependendo do valor que 
lhe foi atribuido, 


Exemplos 


Já vimos que em PHP as 


rariáveis devem iniciar com o símbolo $. Após esse 
simbolo deve vir o identificador da variável, ou seja, o nome pelo qual ela será 
referenciada durante a execução do programa, Esse identificador não pode 


iniciar Com um número. 


às números podem aparecer eim qualquer posiçã 

do identificador, menos na primeira, Exemplos de variáveis válidas e inválidas: 
válidas 

$notal 

Scasaiio 

Shiscê 

Sgremio. 2 vezes campeao america 


Inválidas 


Subassustar 


iSQnacadeíra 
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Maiúsculas e minúsculas (case-sensitive) 


É recomendável que você utilize sempre identificadores com letras minúscu- 
las, pois o PHP faz a distinção entre maiúsculas e minúsculas. Se você começar 
a misturar os dois tipos de letras, pode ocorrer uma confusão na utilização da 
variável, já que $nota aluno não é a mesma coisa que $Nota aluno, imagine 
se um aluno tirou nota 10, e esse valor foi armazenado na variável nota aluno. 
Na hora de imprimir a nota do aluno, você digita a seguinte linha: 


<?php 
echo $Nota aluno; 


?> 


Pobre coitado, está reprovado, pois você imprimiu a variável errada. Por isso 
tome cuidado: o PHP distingue letras maiúsculas e minúsculas, 


Escopo das variáveis 


Mais adiante veremos o uso de funções (functions) em PHP. Porém, você já 
deve conhecer um pouco sobre o assunto. Funções geralmente são trechos de 
código que utilizamos com frequência, e para que não tenhamos de repetir o 
código a toda hora, cria-se uma rotina com aquele código, e quando necessá- 
rio ativa-se essa rotina. Veremos com detalhes esse assunto mais adiante. 


Quando uma variável é utilizada dentro de uma função, pode haver uma outra 
variável com o mesmo nome que é utilizada em outra função, ou no código do 
programa principal. São espaços de memória diferentes, e cada uma funciona 
dentro do seu contexto, ou seja, a variável usada dentro da função funciona só 
ali dentro, Fora dali seu valor não é acessível em nenhuma outra parte do pro- 
grama. 


No entanto, se quisermos, podemos usar dentro de uma função o valor de 
uma variável existente também no programa principal, e para isso há duas 
formas: 


D defini-la como global no início da função; 


2) utilizar o array predefinido $GLOBAIS, que utiliza os nomes das variáveis 
como chave associativa. 


Vamos ver exemplos envolvendo todos os tipos citados: 
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& exemplo4 4.php 


<?php 
$num = 5000; 
function testa escopol O 
{ 
$num += 5; 
echo $num- “abro” 
} 
echo $num . “abro”: 


testa escopol(); 


F> 


Após a execução do exemplo serão mostrados na tela os valores 5000 e na 
linha de baixo 5. Dependendo da configuração do seu PHP, ele poderá mos- 
trar até uma mensagem de aviso, informando que existe uma variável não defi- 
nida (Undefined variable). Isso ocorre porque a variável $num existente den- 
tro da função testa escopo! é válida somente dentro da função, e quando so- 
mamos seu conteúdo (que dentro da função é nulo) com 5, temos como resul- 
tado 05, O comando echo executado fora da função mostrará o valor da vari- 
ável $num atribuído no início (5000), pois as alterações feitas dentro da função 
não alteram o valor da variável global, 


Muitas vezes temos a necessidade de utilizar o valor da variável global dentro 
das funções. Vejamos um exemplo: 
& exemplo4. 5.php 


<?php 
$num = 5000; 


function testa escopol O 


{ 

global $num; 

$num += 5; 

echo $num , “<br>”; 
} 


echo $num , “ebr>”; 


testa escopol(); 


?> 
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Após a execução deste programa o resultado apresentado será o seguinte: 


O Grêmio foi Campeão da América em 1983 e 1995 


Com certeza você utilizará bastante a interpolação de variáveis. Deve-se tomar 
cuidado, porém, quando se escrever uma variável dentro de uma string e hou- 
ver um ou mais caracteres logo ao lado da variável. Exemplo: 


a exemplo4 9.php 


«<?php 
$x = “gri”; 
echo “Eu sou $xcolor"; 


7> 


O objetivo desse programa seria imprimir na tela a frase Eu sou tricolor. Mas se 
você executá-lo a única coisa que será mostrada na tela é o seguinte: 


Eu sou 


É possível até que seja exibida uma mensagem de aviso, informando que exis- 
te uma variável não definida (Undefined variable). Isso ocorre porque o PHP 
procurará pelo valor de uma variável chamada $xcolor, que na verdade não 
existe, e por isso nada será mostrado nesse local, Para resolver esse problema, 
existem duas maneiras, A primeira é a seguinte: 


& exemplo4 10.php 


<?php 
$x = “tri”; 
echo “Eu sou $ixicolor"; 


7> 


Uma maneira é colocar a variável entre chaves para que o PHP saiba onde 
termina o identificador. Outra maneira é escrever o comando de forma dife- 
rente, sem usar a interpolação de variáveis e usando a concatenação: 


& exemplos 11.php 


<?php 

$x = “tri”: 

echo “Eu sou * . $x . “color”; 
?> 


Escolha a forma que lhe parecer mais simples. 


Variáveis criadas durante a execução 


Em diversas ocasiões é muito útil criarmos variáveis dinamicamente, ou seja, 
durante a execução do programa. Essa técnica funciona da seguinte maneira: 
utiliza-se o valor de uma variável para servir como identificador para outra que 
é criada. Para isso utilizamos duas vezes o símbolo $, ou seja, devemos usar $$. 
Acompanhe o exemplo a seguir: 


<?php 
$texto = “Porto alegre"; 
$futuro. identificador = “cidade”; 


$$futuro identificador = $texto; 


echo “<h2 alignscenter>": 
echo “Minha cidade é fcidade”: 
echo “«/hł>"; 


7> 


Se você salvar esse programa como progó.php, e executá-lo por meio de seu 
navegador, você verá a seguinte tela: 


: Desenvolvendo Websites com PHP- Microsol! Intom 


http AncalhostAvrophp/progê. php 


Minha cidade é Porto Alegre 


Figura 4.2 — Resultado gerado pelo programa progó.php. 


Veja que a variável $ruim foi criada dinamicamente. Primeiro o valor “cidade” 
foi atribuído à variável $/uturo identificador, e depois com o uso de $$ o valor 
“cidade” tornou-se o identificador da variável recém-criada. À variável criada 
Scidaderecebeu o valor da variável Stexto, e logo após esse valor foi mostrado 
na tela após a frase “Minha cidade é Porto Alegre. 


Guarde bem esse conceito de variáveis com nomes dinâmicos, pois existirão 
situações em que esse recurso pode ser a única solução possível para resolver 
determinado problema. 


Tipos das variáveis 


No PHP existem variáveis dos tipos numéricas, alfanuméricas (strings), arrays 
e objetos. Vamos ver cada um desses tipos: 


Numéricas 


As variáveis numéricas podem possuir valores inteiros ou reais (ponto flutu- 
ante). Uma variável é definida como numérica no momento em que atribui- 
mos um valor numérico a ela. Veja alguns exemplos: 


$numero = 10: 


$x = 5; 

Snumero. hexa = 0x0b; // valor em hexadecimal 
$y = 15.002; 

$a = 200,3; 


Alfanuméricas (strings) 


São cadeias de caracteres que, conforme vimos anteriormente, podem ser de- 
limitadas por aspas simples () ou aspas duplas (O: Quando utilizamos aspas 
duplas, podemos incluir caracteres de controle no meio da string. Exemplos: 
Snome = “Claúdiomar': 
fprofissãao = “Pedreiro”; 


$texto = “Boa tardelnseja bem-vindo ao meu site!” 


Arrays 


As variáveis comuns (também chamadas de variáveis escalares) podem arma- 
Zenart apenas um valor por vez, Um array (vetor) pode armazenar vários valo- 
res ao mesmo tempo, pois se trata de uma estrutura de armazenamento que, 
assim como as variáveis, possui um identificador, mas além disso há um índice 
associado (que pode ser um número ou um texto), e cada índice indica uma 
posição de memória em que fica armazenado um elemento do array. O índice 
deve aparecer entre colchetes (M logo após o identificador do array. 


Vamos ver um exemplo para você entender melhor o conceito de array: na 
entrada de um edifício há um daqueles armários com diversas gavetas para 
guardar correspondências, uma para cada apartamento. Podemos comparar o 
armário com o array, e os apartamentos com os índices do array. Ou seja, exis- 


te apenas um nome identificador, que é o armário, mas, se um morador do 
edifício chega para pegar suas correspondências, ele deve acessar a gaveta 
correspondente ao seu índice, que é o número do seu apartamento. 


Os arrays são muito úteis quando precisamos realizar automatização de tarefas 
em nossos programas. Imagine que os nomes de todos os moradores de um 
edifício devem ser mostrados na tela. Obviamente não seria viável que utili- 
zássemos variáveis escalares para armazenar os nomes. Se fossem 60 nomes, 
teríamos 60 variáveis, e para mostrar os valores na tela deveríamos usar 60 
vezes o comando echo, Mas se os nomes dos 60 moradores estivessem guar- 
dados em um array, bastaria que utilizássemos um comando de repetição (que 
veremos mais adiante) para imprimir desde a primeira posição do array até a 
última, ou seja, variando o índice de 0 até 59. Veja à seguir alguns exemplos de 
armazenamento em arrays: 


$vetor[0] = 30; 
Svetoríl] = 40; 
Svetor[5] = 50; 


$vetor[15] = 60; 


Se não colocarmos o índice do vetor entre colchetes, o PHP procurará o últi- 
mo índice utilizado e incrementá-lo, armazenando assim o valor na posição 
seguinte do array, conforme mostra o exemplo a seguir: 

$vet[ ] = “Grêmio”; 


Svetl ] 


B 


“Campeão”: 


Nesse exemplo teremos o valor “Grêmio” armazenado em $vedO) e o valor 
“Campeão” armazenado em $vedll. 


Até agora só vimos exemplos em que o índice do array é um valor numérico, 
mas o índice também pode ser um texto, e nesse casos o texto é chamado de 
chave associativa. 

$vetor[“time"] = “Grêmio”; 

$vetor["titulo"] = “Campeão da américa”; 


$vetor[“ano"T = 1995; 


Repare que cada posição do array pode ser de um tipo diferente. Os valores 
das posições referenciadas por time e título são do tipo string, mas o valor da 
posição referenciada por ano é numérico, Outra coisa que pode acontecer é O 
array possuir índices numéricos e strings ao mesmo tempo. Não há problema 
nenhum em usar os dois tipos de índices no mesmo array. 
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Existem também as matrizes, que são arrays multidimensionais. Essas estrutu- 
ras de armazenamento também possuem um único identificador, mas possu- 
em dois ou mais índices para referenciar uma posição de memória. Imagine 
que queremos armazenar na memória os nomes dos melhores clubes do fute- 
bol brasileiro, separando-os por Estados e cidades, Podemos fazer isso utili- 
zando um array bidimensional, como mostra o exemplo a seguir: 


Selube ["RS"] ["Portoalegre"] = “Grêmio”; 
Sctube ["RS"] ["caxias”] = Juventude”; 

fclube [“R$"] [“Bentogoncalves”] = “Esportivo”: 
Sclube ["mG"] [“BeloHorizonte”] = “atlético”: 
šclube [“mG"] ["NovaLima"] = “vila Nova"; 
Sclube [“MG"] [ºIpatinga”] = “Ipatinga”; 

Sclube ["sp"] [“Saopaulo”] = “Corinthians” 


fclube [ºsp"] ["americana”] = “Rio Branco”: 


O exemplo apresentado mostra um array bidimensional, mas podemos usar 
arrays com mais de duas dimensões, bastando acrescentar mais colchetes com 
seus respectivos índices. Outra forma de criar um array é por meio da função 
array do PHP. Veja o exemplo a seguir: 


& exemplo4 12.php 


<?php 
fvetor = array (10,50,100,150,200): 
echo $vetor[2] . “<br>” 
Svet = array (1, 2, 3, "nome"=>" Joaquim"); 
echo $vet[0] . “<br>”; 


echo $ver[“nome"]: 


?> 


Após a execução desse programa os resultados mostrados na tela serão os 
seguintes; 

100 

1 


Joaquim 


Lembre-se de que o array se inicia na posição 0 (zero), por isso apesar de ser o 
terceiro elemento do array, o 100 foi o primeiro valor mostrado, pois seu indi- 
ce é 2. Depois foi criado um array que possui índices numéricos e também 
uma chave associativa. Por meio do comando echo mostramos na tela os valo- 
res de duas posições desse array. 


Objetos 


veremos mais adiante o que são classes. Dentro das classes temos funções 
definidas. Criamos uma variável para instanciar uma classe, e essa variável é 
chamada de objeto. Um objeto pode acessar funções definidas dentro de uma 
classe. Se você alguma vez já estudou programação orientada a objetos, esse 
conceito deve lhe ser familiar. Veja um pequeno exemplo: 


a exemplo4 13.php 


<?php 
class Teste 
{ 
function Saudacao() { 
echo “oi pessoali”; 
} 
} 


Sobjeto = new Teste; // fobjeto se torna uma instância da classe Teste 
Sobjeto -> Saudacao O); 


?> 


Ao criar uma instância da classe Teste na variável objeto, podemos acessar as 
funções definidas dentro da classe. Esse programa mostrará a mensagem “Oi 
pessoal”, 


Operadores 


Por meio dos operadores nós informamos ao PHP o que deve ser executado, 
Exemplos: atribuir um valor a uma variável, realizar operações aritméticas 
(soma, subtração etc.), realizar comparação de valores, para testar se um é 
maior ou menor que o outro, etc, Vamos ver os seguintes tipos de operadores: 


* Operadores aritméticos. 

* Operadores binários. 

* Operadores de comparação. 
* Operadores de atribuição. 

* Operadores lógicos, 


* Operador ternário, 
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Operadores aritméticos 


Utilizando esses operadores, você poderá efetuar qualquer operação matemá- 
tica com dados do tipo numérico, como, por exemplo, somar, subtrair, multi- 
plicar, dividir etc. Confira a tabela com os operadores aritméticos do PHP: 


Operador Operação 


+ Adição 

- Subtração 

* Multiplicação 

i Divisão 

% Resto da divisão 


O PHP possui também outros operadores aritméticos, que atuam em apenas 
um operando. Esses operadores são bastante úteis, pois nos permitem realizar 


de forma simples operações, como troca de sinal, incremento ou decremento 
de valor etc. 


Se você já programou em linguagem C, deve lembrar do incremento utilizan- 
do o operador ++. No PHP também é possível utilizá-lo. Vamos conhecer to- 
dos esses operadores com a tabela a seguir: 


Operador Descrição | 


-oper Troca o sinal do operando. 

++aper Pré-incremento, Primeiro incrementa o valor do operando e depois realiza 
a operação. 

-Oper Pré-decremento. Primeiro decrementa o valor do operando e depois realiza 
a operação. 

opera+ Pós-incremento. Primeiro realiza a operação e depois incrementa o operando. 

oper- 


Pós-decremento. Primeiro realiza a operação e depois decrementa o 
operando. 


Os operadores mostrados na tabela também são conhecidos como operado- 
res unários, pois necessitam apenas de um operando, ao contrário da adição, 
subtração e outras operações que necessitam de pelo menos dois operandos. 


Se o objetivo for somente incrementar o valor de uma variável, pode-se sim- 
plesmente digitar o nome da variável seguida do operador ++, Exemplo: 


Econtador++; 


O pré-incremento (+roper) e o pós-incremento (opere+) diferem um do outro 
se tivermos uma atribuição de valor a uma variável ou a avaliação de uma 
expressão. Vamos ver um exemplo envolvendo os dois tipos para que seja 
mais bem entendida a distinção entre eles: 


a 


<html> 

<body> 

<?php 
$a 
$b 


H 


# 
un owo a 


$e = 
$resl = ++$b - $a; 
$resd= $e- + $a; 
Sresã= -$a + $ctti 
echo “a = $a<br> b = $bebr> € = Se<br><br>"; 
echo “resi = $resicbr> res? = $resZ<br> res3 = $res3<br>"; 
?> 
</body> 
«</html> 


Salve esse programa como prog? php e veja o resultado em seu navegador. 
Você uma tela como a da figura 4,3: 
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EE) hitp:/Mocalhost/ivrophp/prog?. php 


Figura 4.3 — Resultado gerado pelo programa prog7.php. 


Agora vamos analisar os resultados. A variável $res1 recebeu o valor gerado 
pela expressão ++$b - $a, ou seja, a variável $2 foi incrementada (passou do 
valor 3 para 4) e desse novo valor de $4 foi subtraído o valor da variável Sa, 


que vale 1. O resultado foi 4-13. O 3 foi atribuído à variável $res7, como você 
pôde ver na figura 4.3. 


A variável $res2 recebeu o valor gerado pela expressão $c- + $a, Houve um 
pós-decremento na variável $c, ou seja, primeiro foi feita a soma da variável $c 
com a variável $a, e o resultado foi atribuído à variável $resz, e depois dessa 
atribuição o valor da variável $c foi decrementado. Ao terminar a execução 
dessa linha a variável $res2 ficou com o valor da soma $c+ta, que vale 5+1 = 6, 
ea variável $c, que possuía o valor 5 passou a valer 4 após o decremento. 


A variável $res3 recebeu o valor gerado pela expressão --$a + $c++, Houve um 
pré-decremento na variável $a, que passou de 1 para 0, e esse valor foi soma- 
do ao valor da variável $c, resultando em: 0+4 = 4. Esse resultado (4) foi atribu- 
ido à variável $res3, como você pode notar na figura apresentada, Após reali- 
zada essa operação foi feito o pós-incremento da variável $c, que passou de 4 
para 5, À Figura 4.3 mostra os valores finais de cada uma das variáveis após a 
execução do programa, 


Na verdade esses operadores que acabamos de ver deixam seu programa muito 
mais simples em PHP, pois com o uso deles você pode fazer em apenas uma 
linha de código o que faria em duas ou mais linhas se não os usasse, Entenden- 
do como eles funcionam, seus códigos ficarão mais simples e claros. Agora 
que você já está sabendo tudo de pré e pós incremento, vamos passar para O 
próximo tipo de operadores: os binários. 


Operadores binários 


Esses operadores atuam em um nível de abstração bem mais baixo: trabalham 
diretamente com bits. Podem ser utilizados para fazer comparações binárias 
(bit a bit), inverter os bits de um operando, deslocar bits para direita (cada 
deslocamento para a direita equivale a uma divisão por 2) ou esquerda (cada 
deslocamento para a esquerda equivale a multiplicar o número por 2). Em 
alguns casos é interessante usar os operadores binários. Veja a tabela a seguir 
para conhecer esses operadores: 


Uperador Descrição 


=-0p1 inverte os bits de opt. 

opi & op? Operação E (AND) bit a bit, 
opt | op2 Operação OU (OR) bita bit, 
opl "ope Operação OU exclusivo (XOR). 
opt>>n Desloca opf n bits à direita. 
opl<<n Desloca op1 n bits à esquerda. 


Vamos ver alguns exemplos: 


& exemplo4 14.php 


<html> 

<body> 

<?php 
$num = 14; 
$deslocado = $num >> 1; // desloca 1 bit para direita 
echo $deslocado; 

?> 

</body> 

</html> 


No exemplo apresentado estamos pegando o valor 14 (que equivale a 1110 na 
base binária) e, deslocando um bit a direita, o que equivale a dividi-lo por 2, O 
resultado escrito na tela será a divisão de 14 por 2, que dá 7 (equivalente na 
base binária a 0111). 


Perceba que o número que vem após o operando >> representa o número de 
bits que o operando será deslocado para a direita, portanto se tivermos o nú- 
mero 2, O número será dividido por 4 (duas divisões sucessivas por 2). Se após 
o operador >> houver um número n, estaremos dividindo o operando por 2". 
Outro lembrete importante é que quando efetuarmos essas operações com 
bits, teremos sempre como resultado um número inteiro, conforme é mostra- 
do no exemplo a seguir; 


&a exemplo4 15.php 


<html> 

<body> 

<?php 
$num = 15; 
$resultadol = $num >> 1: // desloca 1 bit para direita 
$resultado2? = $num << 2; // desloca 2 bits para esquerda 
echo Sresultadol; 
echo “<br>”; 
echo Sresultado?: 

?> 

</body> 

</html> 
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Após a execução desse programa, serão mostrados na tela os valores 7 e 60, 
que foram os valores armazenados respectivamente em $resultado! e $resul- | 
tado2, Primeiro a variável $resultado! recebeu o número 15 (1111 em binário) | 
deslocado 1 bit para a direita, que resulta em 7 (0111 em binário). Na linha | 
seguinte a variável $resultado? recebeu o número 15 deslocado 2 bits para a 
esquerda, o que equivale a multiplicá-lo 2 vezes por 2, resultando em 15*2*2 = 
60 (111100 em binário). 


Operadores de comparação 


Também chamados de condicionais. São aqueles que executam comparações 
entre o valor de duas variáveis, ou de uma variável e um texto, ou uma variável 
e um número, Com eles podemos testar por exemplo, se uma variável possui 
um valor maior que a outra ou se possui um valor maior que determinado 


número, ou se o retorno dado pela chamada de uma função é verdadeiro ou 
falso. Veja a tabela a seguir: 


Operador Descrição 

opi ==op2 Verdadeiro se op? for igual a opa. Co 
opl >= ope Verdadeiro se opt for maior ou igual a op2. 

opt <= op? Verdadeiro se op! for menor ou igual a op2. 

opi!= op? Verdadeiro se op? for diferente de op2. 

opl «> op2 Também serve para representar diferença. 

op! > opa Verdadeiro se op! for maior que op2. 

opi < op? Verdadeiro se op? for menor que op2. 


O operador de comparação == pode ser usado tanto na comparação de núme- 
ros como na comparação de textos, ao contrário de linguagens como C, que 
utilizam comandos específicos para comparação de dados alfanuméricos. 


Operadores de atribuição 


Atribuição é o termo usado para representar a colocação de um valor em uma 
variável, A variável que receberá a atribuição encontra-se sempre do lado es- 
querdo do operador, e esta recebe o valor gerado pela expressão ou operador 
que está a direita. Além disso temos diversas variações dos comandos de atri- 
buição, que podemos utilizar para facilitara programação. São operadores que, 
assim como os operadores de incremento (++) e decremento (==), servem 
para deixar o código mais simples e mais fácil de ser programado. Veja a seguir 
a tabela dos comandos de atribuição: 


Operador Descrição in 
op jo opa l op1 recebe o valor de opa. 

opl += 0p2 Equivale a op1=0p1+0p2. 

opi -= op? Equivale a opi=0p1-op2. 

opl *= op? Equivale a opT=0p 1*op2. 

op1 i= op? Equivale a op1=0p 1/0p2. 

op! = op? Concatenação: equivale a op1=0p1.0p2. 
op %z op? Equivale a op1=0p1%0p2. 

opi <<= opê Equivale a opt=z0p1<<0p2. 

opi >>= op? Equivale.a op 1=0p 1>>0pê. 

opt &= op? Equivale a op1=0p1&0p2. 

op1 |= op? Equivale a op1=0p1|0p2. 

opi ^= op2 Equivale a opi=op?opa, 


comparação == pelo operador. de atribuição =. O programa acaba gerando resultado incorreto, 
pois se queremos fazer uma comparação, por exemplo, entre as variáveis fa e $b, devemos usar 
a expressão $a==$b, e não $a=$b. Use com atenção esses operadores para evitar resultados 
errados na execução do programa. 


Vamos ver um exemplo envolvendo operadores de atribuição: 


& exemplo4 16.php 


<html> 

<body> 

<?php 
Ssona=0: 
$valori = 10; 
fvalor? = 20; 
$valor3 = 30; 
fsoma += $valor1; // Ssoma fica com 10 
fsoma +=Svalor2; /! Ssoma fica com 10420 = 30 
fsoma *= $valor3; /! Ssoma fica com 30730 = 900 
fsoma %= 100; /! Asoma fica com 900%100 = O 
echo $soma; 

?> 

</body> 

</html> 


Como você pode ver pelos comentários do programa, o valor que será mostrado 
na tela é zero. O último operador utilizado (%=) representa o resto da divisão (em 
outras linguagens é chamado de MOD). Dividindo 900 por 100 temos como re- 
sultado exato 9, portanto o resto da divisão é zero. No exemplo anterior utiliza- 
mos os operadores +=, *= e %= para atribuir à variável $soma resultados de o pera- 
ções realizadas entre a própria variável $soma e outro operando. Perceba que o 
código fica bem mais claro e fácil de entender com o uso desses operadores de 
atribuição, 
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Operadores lógicos 


São aqueles que retornam o valor verdadeiro ou falso, Veja a tabela a seguir: 


Operador Descrição , 
tp Verdadeiro se opt tor falso, 0 0 
opt AND op? Verdadeiro se op! E ope forem: verdadeiros. | 
opt OR op? Verdadeiro se opt QU op2 forem verdadeiros. | 
op1 XOR opa Verdadeiro se só op! ou só op2 for verdadeiro. | 
opi && op? Verdadeiro se op? E opa fotem verdadeiros. | 
opt || op2 Verdadeiro se op1 OU opa forem verdadeiros. 


Depois de observar essa tabela, você provavelmente está com dúvidas quanto 
à diferença entre os operadores AND e &&, e também os operadores OR e ||. 
A diferença entre eles é a precedência dos operadores na avaliação de expres- 
sões, A precedência mais alta é dos operadores && e | |, enquanto os operado- 
res ANDe OR possuem precedência mais baixa. Por isso, tome muito cuidado 
com ao utilizá-los, pois podem gerar resultados diferentes dependendo da or- 
dem em que forem colocados. Veremos mais diante um tópico especial sobre 
precedência de operadores. 


Um exemplo típico no qual usamos operadores lógicos é o caso de testar se 
todos os campos obrigatórios de um formulário foram preenchidos, Suponha 
que tenhamos um formulário em que os campos nome, e-mail e CPF são obri- 
gatórios. Certamente no programa que recebe os dados do formulário haveria 
um teste como o mostrado no trecho de programa a seguir: 


& exemplo4. 17.php 


<html> 
<body> 
<?php 


if (emptyC$nome) OR emptyCSemail) OR empty($cpf)) 


{ 
echo “você deve preencher os campos nome, e-mail e CPF"; 
exit; 
} 
7> 
</body> 


«fhtm!> 
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Nesse exemplo temos uma expressão sendo avaliada. A função emptyO, que 
significa vazio em português, retorna verdadeiro se a variável estiver vazia, € 
retorna falso se houver algo na variável. Então estamos testando sea variável 
$nome está vazia ou a variável $email está vazia ou a variável $cpfestá vazia. 
Se pelo menos uma das três estiver vazia o resultado será verdadeiro, e isso 
fará com que seja impressa a mensagem “Você deve preencher os campos 
nome, e-mail e CPF, e logo após o programa será encerrado por meio do 
comando exit. 


Mais adiante veremos com detalhes os comandos condicionais, como o if mas 
você já pode notar que os operadores lógicos têm relação direta com esses 
comandos, pois os comandos condicionais avaliam o resultado de expressões 
que utilizam os operadores lógicos. 


Acompanhe as tabelas a seguir para ver os resultados gerados em cada um dos 
operadores de acordo com o tipo de expressão avaliada: 


Operador AND (E) 
pl Exp2 Resultado 
É : UI e 
v F F 
F V F 
F F F 
Operador OR (0U) 
Expl Exp? Resultado 
È > "o 
V F v 
F v V 
F F F 


Exp1 Exp2 Resultado 
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Operador ! (NOT) 
V F 
F V 
Operador ternário 


É uma forma abreviada de usar o comando condicional if que veremos mais 
adiante. Uma condição é avaliada, e, se ela for verdadeira, atribui-se um valor à 
variável, e se a condição for falsa atribui-se um outro valor. À sintaxe é a se- 
guinte: 


cond ? expl : exp? 


Vamos ver um exemplo de uso desse operador, embora seja mais recomenda- 
do utilizar o comando condicional if, por ser mais simples de usar. Observe: 


Snota = (Sfrequencia >= 0,75) ? ($nota+2) : (Snota-2); 


Quando o PHP executar a linha anterior, se a variável Sfrequencia possuir um 
valor maior ou iguala 0,75, a variável $nota será aumentada de duas unidades, 
caso contrário haverá a diminuição de duas unidades. Escrevendo essa mesma 
operação por meio do comando if temos o seguinte código: 
<?php 
if ($frequencia >= 0,75) 
fnota = $nota+2; 
else 


$nota = Snota-2; 


É 


?> 


Utilizando o comando iffica bem mais fácil entender qual é o objetivo do códi- 
go, pois conseguimos fazer perfeitamente a distinção de qual é a condição e 
quais operações serão executadas após a avaliação desta. À utilização do opera- 
dor ternário, apesar de utilizar um número menor de linhas para a operação, 
requer um pouco mais de prática para que nos acostumemos com sua notação. 


Precedência de operadores 


Para evitar erros de lógica em seus programas é fundamental que você conhe- 
ça a ordem utilizada pelo PHP para tratar os operadores. A tabela a seguir mos- 
tra a ordem decrescente de precedência que o PHP segue ao encontrar diver- 
SOS operadores no programa: 


Operador Descrição O 
a ++ — Negativo, não-lógico, inversão de bits, incremento e decremento. 
+i% Multiplicação, divisão e resto da divisão. 
+. Adição, subtração e concatenação. 
<< >> Deslocamentos binários. 
> < >m <= Maior, menor, maior ou igual, menor ou igual, 
zs |z <> igual e diferente. 
& AND binário. 
^ XOR binário. 
| OR binário. 
88, l AND lógico. 
ii OR lógico. 
7 Operador ternário. 
= pm cm tu je Gu ko «x «qu ppa da 
Operadores de atribuição. 
AND AND lógico (de menor prioridade). 
XOR XOR lógico (de menor prioridade). 
OR OR lógico (de menor prioridade). 


É importante lembrar que primeiro o PHP executará todas as operações que 
estiverem entre parênteses, Se dentro dos parênteses houver diversas opera- 
ções, a precedência de operadores será utilizada para definir a ordem. Depois 
de resolver todas as operações que aparecem entre parênteses, o PHP resol- 


verá o resto da expressão baseando-se na tabela anterior para determinar a 
ordem de avaliação dos operadores. 


Quando houver operadores de mesma prioridade em uma expressão, e não 
existirem parênteses, o PHP resolverá a expressão da esquerda para a direita, 


Observe o seguinte trecho de programa: 


& exemplo4 18.php 


<?php 
$num = 5; 
$resultado = 8 + 3% 2 + ++$num; 
echo "$num<br>"; 


echo $resultado; 
?> 


O resultado mostrado na tela será: 
6 
20 


Desenvolvendo Websites com PHP 


Observe que o operador ++ tem prioridade mais alta que os operadores + e *, 
por isso a primeira operação realizada pelo PHP foi o incremento do valor da 
variável $num. O segundo operador de maior prioridade no exemplo apre- 
sentado é o de multiplicação, portanto a segunda operação realizada foi 3*2. 
Após essas duas operações, ficamos com a soma 8+6+6, Note que temos dois 
operadores iguais (de adição), portanto, como têm a mesma prioridade, a ex- 
pressão é avaliada da esquerda para a direita: 8+6 = 14. E depois 14+6 = 20, que 
foi o resultado mostrado na tela. 


Como vimos na tabela anterior os operadores de multiplicação (*) e resto da 
divisão (%) têm a mesma precedência, Nesses casos é muito importante a uti- 
lização de parênteses para evitar resultados não desejados. Veja o exemplo a 
seguir: 


& exemplo4 19.php 


<?php 
$num = 7; 
$resultado = 8 * $num X 2; 
echo $resultado; 


?> 


Após à execução desse programa será mostrado o resultado 0, pois primeiro foi 
realizada a multiplicação 8*7 = 56. E depois foi calculado o resto da divisão de 56 
por 2, que dá 0. Agora observe esse mesmo exemplo, mas utilizando os parênte- 
ses para determinar a ordem que deve ser utilizada para aplicar as operações: 


€a exemplo4. 20.php 


<?php 
$num = 7; 
$resultado = 8 * ($num & 2); 
echo $resultado; 


?> 


Agora o resultado mostrado não será 0, e sim 8. Isso porque determinamos por 
meio dos parênteses que primeiro deveria ser realizada a operação do resto da 
divisão de 7 por 2, que resultou em 1. Depois disso foi feita a multiplicação 
desse valor por 8, resultando em 8*1 = 8, Mediante esses dois exemplos, você 
pode perceber a importância da precedência dos operadores e do uso dos 
parênteses em expressões. Muitas vezes O uso incorreto dessas informações 
causa a exibição de dados incorretos na saída dos programas. 
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Estruturas de controle em PHP 


Neste tópico veremos comandos que você utilizará para estruturår seus pro- 
gramas escritos em PHP, São comandos comuns à maioria das linguagens de 
programação, e o uso deles é fundamental para realizar decisões lógicas, testar 
se determinada expressão é verdadeira, repetir um bloco de comandos por 
um certo número de vezes ou até que uma condição seja atingida, Leia com 
atenção para ir se acostumando com a sintaxe desses comandos no PHP, Vere- 
mos com detalhes os comandos condicionais e os comandos de repetição. 


Os comandos condicionais são: 
s if 

* switch 

Os comandos de repetição são: 
+ while 

* do. while 

è for 

e foreach 


Além disso veremos o significado dos comandos break e continue, para con- 
trolar o fluxo dentro das repetições (loops). 


Comandos condicionais 


Utilizando comandos condicionais temos a oportunidade de avaliar uma ex- 
pressão e, dependendo do resultado obtido, executar um trecho de código 
diferente. Esses comandos são usados sempre que há necessidade de uma 


if 


tomada de decisão dentro de um programa. Por exemplo: se a nota for maior 
ou iguala 7, imprimir o valor aprovado, senão imprimiro valor reprovado. Os 
comandos condicionais são ife switch. Verificaremos exemplos envolvendo 
cada um deles: 


Comando que avalia uma expressão e, dependendo do resultado, é executa- 
do um conjunto diferente de instruções. O comando if pode possuir como 
complemento o elseife/ou o else. Observe a sintaxe do comando if 
If Cexpi) 
Tblocol > 
elseif ( exp? ) 
{ bloco? > 
else 


{ blocos + 
Podemos ler essa sintaxe da seguinte maneira: 
* se expl for verdadeira, execute blocol 
* senão se exp2 for verdadeira, execute bioco2 
* senão execute bloco3 


É importante lembrar que apenas um dos blocos será executado, e depois 
disso a execução continuará após o comando if. 


Em português if significa “se” e o else significa “senão”. Dentro da construção 
do comando if, podem aparecer diversos elseif cada um avaliando uma ex- 
pressão. Quando a expressão avaliada pelo comando ifresultar em valor ver- 
dadeiro (True), será executado o bloco de comandos definido logo a seguir, 
que aparece entre chaves ([]). Se não houver a delimitação do bloco por cha- 
ves, será executada apenas a primeira linha após o if Após executar esse bloco 
de comandos, a execução do programa será desviada para o fim do comando 
if, e as demais expressões (contidas no elseife no else) não serão avaliadas, 
pojs o comando if escolhe apenas um entre vários conjuntos de instruções 
para execução. 


Se a condição avaliada no comando if for falsa (False), o bloco de comandos 
seguinte não será executado, e será testada a expressão contida no primeiro 


elseif (se houver). Se todas as expressões avaliadas (do ife do elseif) forem 
falsas, o bloco de comandos executado será aquele que vem após o else. Veja 
um exemplo no trecho de programa a seguir: 


gs exemplo5. 1.php 


<?php 
$proval = 7; 
iprovaZ = 5; 


$nota = ($proval+$prova2) / 2; 
if ($nota<3) 

$desempenho = “PÉSSIMO”; 
elseif ($nota<5) 

Sdesempenho = “RUIM”; 
elseif. Cônota<?) 

$Sdesempenho = “MÉDIO”; 
elseif ($nota<9) 


$desempenho = “BOM”; 


H 


else 
fdesempenho = “EXCELENTE”; 


echo “O seu desempenho foi $desempenho”; 


7> 


Suponha que o aluno tenha tirado 7,0 na primeira prova, e 5,0 na segunda 
prova. No programa anterior seria feita a média aritmética para calcular a nota 
a sá . 1 

final: (7+5)/2 = 12/2 = 6. Portanto, a variável $nota ficaria com o valor 6. 


A expressão avaliada no ifseria falsa, pois 6 não é menor que 3. A expressão 
avaliada no primeiro elseiftambém seria falsa, pois 6 não é menor que 5. No 
segundo elseif, a expressão avaliada retornaria verdadeiro, pois 6 é menor que 
7, e isso faria com que fosse executada a linha: 


Sdesempenho = “MÉDIO”; 
Perceba que não há chaves delimitando um bloco de comandos, e por isso a 
única linha executada foi a que aparecia logo após o elseif Como a expressão 


avaliada resultou em verdadeiro, as demais não serão avaliadas, e o próximo 
comando executado será o echo, que imprimirá na tela o seguinte resultado: 


O seu desempenho foi MÉDIO. 


Note que o comando else não possui expressão a ser avaliada, pois este só será 
executado quando todas as outras expressões avaliadas resultarem em falso. 
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É importante lembrar também que não é obrigatório o uso de elseife else com 
o comando if O ifpode aparecer sozinho, determinando se um bloco de ins- 
truções será executado ou não, Por exemplo: 


& exemplos. 2.php 


<?php 
if (Snota == 10) 
{ 
echo “Parabéns! <br>"; 
echo “você tirou a nota máximal”; 
} 
7> 


Nesse exemplo, se o valor da variável $nota for iguala 10, será mostrada na tela 
a seguinte mensagem: 

Parabéns! 

você tirou a nota máxima! 
Se o valor da variável $nota não for igual a 10, esse bloco de comandos sim- 
plesmente não será executado, e a execução do programa seguirá normal- 
mente. Poderíamos acrescentar um else ao comando, e imprimir outra mensa- 
gem caso o aluno não tirasse nota 10, 


Se você já programou em outras linguagens, já deve ter usado alguma vez o if 
acompanhado de um endif, para determinar o fim do comando. Pois bem, há 
também uma sintaxe alternativa utilizando o endif 
If (expl): 
btocol 
elseif (expo): 
bloco? 
else: 


blocos 


endif; 
G 
Na sintaxe apresentada não é necessário o uso de chaves, pois o PHP entende 
sendo um bloco de comandos desde os dois-pontos (9) até o próximo elseif, 
else ou endif. 
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Se você já programou na linguagem Pascal, deve se lembrar do comando case. 
O switch do PHP tem a mesma função. O comando switch é parecido com o if, 
pois ambos avaliam o valor de uma expressão para escolher qual bloco de 
instruções deve ser executado. Em algumas ocasiões, você tem uma mesma 
variável a ser testada com valores diferentes, e nesse caso é interessante utili- 
zar o switch, que trabalha basicamente com o operador de igualdade, enquan- 
to o if trabalha com qualquer tipo de operador, 


O uso do comando switch torna o código um pouco mais organizado que o if, 
pois esse comando utiliza apenas uma cláusula (case), enquanto o if utiliza 
várias (if, elseif, else e as vezes endif. Veja a sintaxe do comando switch: 


switch (operador) 
í 
case valori: 
«comandos» 
break; 
case valor?: 
«comandos> 


break; 


case valor: 
«comandos» 
break; 

default: 
<comandos> 


break: 


Perceba que após cada bloco de comandos deve ser utilizado o break, para 
que o comando switch seja encerrado e a execução continue após ele, Se não 


utilizarmos o break o PHP continuará a execução dentro do switch, avaliando 
as demais expressões. 


Veja o exemplo a seguir, que mostra dois trechos de programa que fazem a 
mesma coisa, mas um deles utilizando ife o outro, o switch. 


Utilizando if 


<?php 


if CSnumero == 0) { 
echo “número vale 0”; 
} 
elseif ($numero == 1) { 
echo “número vale 1”; 
} 
elseif ($numero == 2) { 


echo “número vale 2”; 


7> 


Utilizando switch 


sa exemplo5_3.php 


<?php 


switch (Snumero) 
{ 
case O: 
echo “número vale 0"; 
break; 
case 1: 
echo “número vale 1"; 
break; 
case 2: 
echo “número vale 2º; 


break; 


?> 
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No comando switch temos também a opção default. Veja o exemplo a seguir: 
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& exemplo5. 4.php 


<?php 


switch ($opcao) 
í 


tat 


case ‘s'i 
echo “você escolheu a opção SIM": 


break; 


És 


case ‘n'i: 
echo “ você escolheu a opção NÃO ": 
break; 

default: 
echo “ A opção digitada é inválida”; 
break; 


} 


?> 


A opção default tem a mesma função da opção else no comando if Se todas as 
expressões anteriores retornarem falso, será executado o bloco de comandos 
que aparece após o default. O uso do default não é obrigatório no comando 
switch. 


Comandos de repetição 


São comandos utilizados para que um conjunto de instruções seja executado 
repetidamente por um número determinado de vezes, ou até que determina- 
da condição seja atingida. Podemos, por exemplo, fazer repetições até que 
uma variável atinja determinado valor, ou até que uma variável seja diferente 
de um valor. Veremos com detalhes os comandos de repetição while, do... while, 
fore foreach. 


while 


Traduzindo para o português, while significa enquanto. O comando while é com- 
posto por uma expressão e por um bloco de comandos. O comando avalia a 
expressão, e enquanto essa expressão retornar o valor verdadeiro, a execução 
do bloco de comandos em questão será repetida, Quando o valor retornado for 
falso, encerra-se o laço de repetição doop), e a execução é transferida para o fim 
do comando while. Assim como no comando if, devemos utilizar chaves como 
delimitadores sempre que o bloco possuir mais de uma instrução para executar. 


Veja a sintaxe do comando: 
while (exp) 
í 


comandos 
} 
Há também uma sintaxe alternativa, utilizando os dois-pontos: 
while (exp): 
comandos 


endwhile; 


No segundo formato não há necessidade do uso de chaves. No primeiro for- 
mato as chaves devem ser utilizadas quando há mais de um comando a ser 
executado no bloco. 


Devemos tomar cuidado para não colocarmos no comando while expressões 
que jamais se tornarão falsas, senão teremos um loop infinito, pois o PHP re- 
petirá para sempre o bloco de instruções. Veja a seguir um exemplo de utiliza- 
ção do comando while: 


se exemplo5. 5.php 


<?php 
icont = 1; 
white (Scont<100) 
í 
echo “O valor atual do contador é $cont <br>"; 


Sconter; 


?> 


A execução desse programa resultará em 99 linhas mostradas na tela: 
o valor atual do contador é 1 
o valor atual do contador é 2 
O valor atual do contador é 3 


“sa. 


o valor atual do contador é 99 


Quando a variável $cont atingir o valor 100, a expressão retornará o valor falso, 
pois 100 não é menor que o próprio 100, e isso fará com que o loop seja encerra- 
do. Se em vez de usarmos a expressão $cont<100 usássemos a expressão $conti=0 
(diferente de zero), teríamos um laço infinito, pois a cada repetição do laço o 
valor de $cont seria incrementado e, desse modo, ele nunca chegaria ao valor 
zero, que é à condição necessária para o encerramento do loop. 


do...while 


A diferença entre o while e o do.. while é que o while avalia a expressão no 
início do laço, e o do... while avalia a expressão no final do laço. Portanto, você 
já pôde perceber que utilizando do... while o laço será executado pelo menos 
uma vez, e utilizando somente while o laço pode não ser executado, caso a 
expressão avaliada retorne falso na primeira avaliação. Se você já programou 
em outras linguagens, deve conhecer o comando repeat ...until, que tem a mes- 
ma função do comando do... while, mas com uma diferença: no comando 
repeat..untilo laço é encerrado quando a expressão retorna verdadeiro, e no 
comando do...while o laço é encerrado quando a expressão avaliada é falsa. A 
sintaxe do comando é a seguinte: 

do 

{ 

comandos 


} while (exp); 


Veja um exemplo: 


& exemplo5_6.php 


<?php 
$numero = 1; 
do 
{ 
echo “O valor atual de número é $numero <br>”; 
Snumero++; 


} while ($numero<4); 


?> 


O resultado gerado pela execução desse programa será: 


O valor atual de número é 1 
O valor atual de número é 2 


O valor atual de número é 3 
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Utilizamos o comando for quando queremos executar um conjunto de instru 
ções um número determinado de vezes. É um comando muito útil que pode 
ser usado, por exemplo, para imprimir todos os elementos de um array, at 
todos os registros retornados de uma consulta a um banco de dados. A sintax 
do comando for é a seguinte: 


for ( inicialização ; condição ; operador ) 
{ 


comandos 


} 


Assim como no ife no while, há uma sintaxe alternativa para o for 

for ( inicialização ; condição ; operador ): 

comandos 

endfor; 
Como inicialização geralmente determinamos o valor inicial da variável que 
controlará o loop. O parâmetro de inicialização poderia ser $cont=0. No se- 
gundo parâmetro devemos colocar a condição que deve ser atingida para que 
o loop continue. Se quiséssemos executar o loop 20 vezes, o valor do parâme- | 
tro de condição seria $cont<20. Quando essa condição retornar o valor falso, o 
loop é encerrado. O último parâmetro geralmente é usado para atualizar O 
valor da variável de controle do loop, fazendo um incremento ou um decre- 
mento (por exemplo, $cont++). Ao final de cada iteração do loop, o valor da 
variável de controle é atualizado automaticamente, dependendo do terceiro 
parâmetro que você definiu quando utilizou o comando for. Veja alguns exem- 
plos de utilização do comando: 


€ exemplo5. 7.php 
<?php 
forCScont=0 ; $cont<10 ; Scont++) 
{ 


echo “A variável \fcont vale $cont”; 


echo “<br>: 


?> 
O resultado gerado pela execução desse programa será o seguinte: 
A variável $cont vale O 


A variável $cont vale 1 


A variável $cont vale 9 
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No comando while muitas vezes temos de incrementar a variável de controle 
ao final do laço, No comando for isso é feito de forma automática quando 
definimos o terceiro parâmetro do comando ($cont++). Ao fim de cada laço a 
variável $cont será incrementada. Veja outro exemplo, agora utilizando o de- 
ciemento: 


& exemplo5 8.php 


<html> 

«body> 

«?php 
echo “Estou fazendo uma contagem regressiva: <br>”; 
for($i=15 ; $i>=0 ; $i-) 


{ 
echo $i. "5 
} 
echo “... FIM”; 
?> 
</body> 
</html> 


Executando essa página em seu browser você verá o seguinte resultado: 


Estou fazendo uma contagem regressiva: 


di dA, 18, 12, 01/10, 0, 8,7,6,5,4,3;/2,1 04, FIMI 


Podemos fazer também o aninhamento de loops. Isso é muito útil quando 
queremos, por exemplo, imprimir na tela todos os elementos de um array bi- 
dimensional. Suponha que temos uma array bidimensional de dimensões 2 x 
2. Poderíamos imprimir todos os elementos desse array utilizando duas vezes 
o comando for de forma aninhada, como mostra O exemplo a seguir: 


& exemplo5 9.php 


<?php 
svetor[0)][0]= “elementogo”: 
Svetor[0][1]= “elementool”; 
$vetor[1][0]= “elementolo”; 
fvetor[1[1]= “elementoll”; 
forCHis0 Sid Si) 
{ 
for($k=0 ;  $k<2 i $k4+) 
{ 
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echo “o elemento da posição $Si,Sk é"; 
echo fvetor [Si] LSk] . "ebr>"; 


7> 


Apesar de não ser muito comum, podemos inicializar mais de uma variável no 
parâmetro de inicialização do comando for, e também podemos ter mais de 
um operador no terceiro parâmetro. Para isso basta utilizarmos a vírgula, con- 
forme mostra o exemplo a seguir: 


<?php 
for( $i=0, $k=10 ; $i<10 : $i++, $k- ) 
{ 
echo “\$i vale $i e \$k vale $k”; 
if ($i==$k) 
(echo “ (os valores são iguais!) } 
echo “<br>”: 
} 
> 


Salve esse programa como prog8,php e execute em seu navegador, Você verá 
a seguinte tela: 
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$i vale O e $k vale 10 
$i vale 1 e Bk vale 9 
$i vale 2 e $k vale 8 


| $ivale 3e $k vale 7 
$i vale 4 e $k vale 6 
| $ivale 5e $k vale 5 (os valores são iguais!) 
| Bivalçõe $k vale 4 
$i vale 7 e $k vale 3 
| Bivale 8 e $k vale 2 
À Sivale 9e $k vale 1 


Figura 6.1 — Resultado gerado pelo programa prog8.php. 


Ao final de cada iteração do laço, o valor das duas variáveis ($/e $4) é atualizado, 


s 


Capítulo 5 * Estruturas de controle em PHP 71 


foreach 


O comando foreach funciona apenas na versão 4 do PHP, O PHP3 não oferece 
esse suporte. O foreach nos oferece uma maneira mais fácil de “navegar” entre 
os elementos de um array. Observe as duas sintaxes possíveis: 


foreach ($nome „array as Selemento) 


{ 


comandos 


ou 


foreach ($nome array as $chave => $valor) 
í 


comandos 
} 


A primeira forma vai do primeiro ao último índice do array definido na variável 
gnome array, e a cada iteração o valor do elemento corrente do array é atribu- 
ido à variável $elemento, e o ponteiro interno do array é avançado. Dessa 
forma, podemos trabalhar com todos os valores do array utilizando apenas a 
variável Selemento. 


À segunda forma faz a mesma coisa, mas com uma diferença: além do valor do 
elemento corrente do array ser atribuído à variável $elemento, a chave (OU 
índice) do elemento atual é atribuído à variável $chave. Acompanhe o exem- 
plo a seguir: 


& exemplos 10.php 


<?php 
$vetor = array (1, 2, 3, 4); 
foreach ($vetor as $v) 
{ 
print “O valor atual do vetor é $v. <br>"; 
} 
$a = array ( “um” => 1, “dois” => 2, “tres” => 3): 
foreach($a as $chave => $valor) { 


print “\fa[Schave] => $valor. <br>": 


?> 
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O programa apresentado mostrará na tela todos os valores do array $vetor, e 
depois mostrará todos as chaves e valores do array $a. O segundo foreach 
desse exemplo mostrará o seguinte: 

Sa [um] => 1. 

$a [dois] => 2. 

$a [tres] => 3. 


Controlando o fluxo de execução 


Existem comandos que podem ser usados em conjunto com essas estruturas 
de controle que acabamos de ver. Esses comandos são o break e o continue. 


Vamos ver qual é a utilidade de cada um deles: 


break 


O break termina a execução do comando atual, que pode ser um if, for, while, 
ou switch. Quando o break é encontrado dentro de algumas dessas estruturas, 
o fluxo de execução passa para o primeiro comando após o término dessa 
estrutura, É um recurso que podemos utilizar para forçar a saída de um laço ou 
de um comando condicional. Acompanhe o exemplo a seguir: 


exemplo5_11.php 


<?php 
$k = 1; 
while ($k < 20) 
{ 
if (Svetor[Sk] == “sair” 
{ break; } 
echo $vetor[$k] . “<br>”; 
Sket; 
} 
?> 


O programa apresentado mostrará na tela os valores de um vetor qualquer. O 
laço poderá ser encerrado de duas formas: 


1) seo valor de $k for maior ou iguala 20; 


2) se algum elemento do vetor possuir o valor “sair”. 
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O comando break também aceita um argumento numérico opcional, que diz 
o número de estruturas que devem ser finalizadas. Portanto, utilizar o coman- 
do break equivale a utilizar break 1, pois quando não há um parâmetro defini- 
do temos a finalização de apenas uma estrutura. Veja a seguir um exemplo 
com a utilização desse parâmetro: 


& exemplo5_12.php 


<?php 
$i = 0; 
$k = 0; 
while ($k < 10) 
{ 
Sitt; 
$k++i 
while ($i < 20) 
{ 
if{($1==10) 
{ 
echo “Encerrando o primeiro while... <br>”; 
break ; 


i 


echo “ Essa linha não vai ser impressalli”; 
} 
elseif ($i==15) 
{ 
echo “Encerrando os dois whiles... ”; 
break 2; 
} 


fitti 


} 


?> 


Nesse exemplo, quando a variável $i chegar ao valor 10,a execução passa para 
dentro do if e quando o break é executado termina imediatamente a execu- 
ção do laço atual. O comando echo que é utilizado após o break não será 
executado. Quando o valor da variável $i chegar a 15, o comando executado 
serão break 2. Esse comando fará com que sejam finalizadas as duas estruturas 
de repetição, e à execução irá continuar após os dois whiles. Esse é o objetivo 
desse parâmetro opcional do break. 
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continue 


O comando continue é utilizado dentro dos comandos de repetição para ig- 
norar o restante das instruções pertencentes ao laço corrente, e ir para a próxi- 
ma iteração (voltando ao início do laço). Veja o exemplo a seguir: 


&a exemplo5 13.php 


<?php 
fvetor = array (1,3, 5, 8, 11, 12, 15, 20); 


for($i=0 | $i<sizeof($vetor) ; $i++) 


{ 
if (Svetor[$i] ¥ 2 Ia 0) // é impar 
{ continue; } 
$num par = $vetor[$i]:; 
echo “O número $num par é par. <br>”; 
4 


7> 


A função sizeof retorna o número de elementos do array $vetor (nesse caso 
retornará o valor 8). Esse programa utiliza um comando for para passar por 
todos os elementos desse array, mas somente os números pares são mostra- 
dos na tela. Sabemos que os números pares quando divididos por 2 apresen- 
tam resto 0, pois a divisão é exata. O programa testa por meio do comando if 
se o resto da divisão é diferente de zero, ou seja, se o número é ímpar. Ao 
encontrar um valor impar, é executado o comando continue, e os comandos 
seguintes não são executados. Com isso a execução retorna ao início do laço, 
co próximo elemento do vetor é acessado. Dessa forma, ao final do laço tere- 
mos somente valores pares mostrados na tela, pois o comando continue evi- 
tou que os impares também fossem mostrados. 


Assim como o comando break, o comando continue também aceita um argu- 
mento numérico opcional, que diz o número de níveis que devem ser reinici- 
ados, ignorando os comandos seguintes. Se utilizarmos, por exemplo, o co- 
mando continue 2 dentro de dois whiles aninhados, a execução volta ao início 
do primeiro while. 
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Funções e classes 


Definição de função 


As funções (functions) são muito úteis para deixar o código dos programas 
mais organizado e mais modular, e além disso elas nos poupam da tarefa de ter 
de repetir determinado código toda vez que precisamos realizar a mesma tarefa, 


Funções são trechos de código que podem realizar qualquer tipo de tarefa, 
como, por exemplo, somar dois números, testar se o valor de uma variável é 
válido, verificar se um número de CPF foi digitado corretamente, transformar 
uma string para letras maiúsculas etc. Funções podem ser ativadas a qualquer 
momento da execução do programa. A sintaxe para a construção de uma fun- 
ção é a seguinte: 


function nome. função (argi, arg?, arg3 “o argn) 
{ 

comandos 

[ return <expressão> ] 


} 


Devemos substituir nome_função por um identificador, que deve ser um nome 
único. O identificador não pode iniciar com número, e além disso não é per- 
mitido a utilização de caracteres como ponto, vírgula, espaço etc. Um caracte- 
re que é bastante utilizado para formar nomes de funções é o _ (sublinhado), 
Definida uma função, podem haver diversas chamadas para ela, que será refe- 
renciada por meio do identificador escolhido. 


Uma função pode, mediante uma chamada, receber diversos valores que cha- 
mamos de argumentos, que na sintaxe estão representados por argi, arg2, arg3 
. argn. Esses argumentos são valores recebidos no momento da chamada, e 


76 . Desenvolvendo Websites com PHP 


que de alguma forma serão processados no código da função. É opcional à 
utilização dos argumentos, Se a função não os recebe, devemos simplesmente 
escrever function nome. função O. 


Sempre que o PHP encontrar uma chamada para uma função, a execução do 
programa é interrompida e o fluxo de execução passa pardo início do código da 
função. Após o término da função, a execução volta ao programa principal no 
mesmo ponto em que foi feita a chamada, e o próximo comando é executado. 


Observe que na sintaxe de uma função existe um comando opcional, que é o 
return. Esse comando existe porque podemos fazer com que a função retorne 
um valor para o ponto em que foi chamada, Utilizamos o return em duas situ- 
ações: 


1) quando queremos atribuir o valor retornado a uma variável; 


2) quando queremos testar (comandos condicionais) o valor de retorno de 
uma função, 


A função pode simplesmente executar uma tarefa e não retornar nenhum va- 
lor, como, por exemplo, uma função que recebe dois valores realiza opera- 
ções aritméticas com eles e mostra o resultado na tela. Esse tipo de função não 
retorna nenhum valor, 


Como criar uma função 


Veja no exemplo a seguir como criar uma função e incluir uma chamada para 
ela no programa principal: 


& exemplo6. 1.php 


<?php 

function soma valores ($valorl , Svalor2 , $valor3) 

{ 
$soma = $valorl + $valor2 + $valor3:; 
echo “A soma dos valores $valori, $valor2 e $valor3 *; 
echo “é Ssoma”; 

} 

$nl = 10; 

$nZ = 20; 

$n3 = 50; 


soma valores ($n1, $n2, $n3); 


> 
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Note que as variáveis que são passadas como parâmetros não precisam ter o 
mesmo nome dos argumentos definidos na função. Isso ocorre porque no 
momento da chamada da função soma, valores, a variável $valor1 receberá o 
valor do primeiro argumento, a variável $valor2 receberá o valor do segundo 
e a variável $valor3 receberá o valor do terceiro. 


A função apresentada não utiliza o comando return, pois seu objetivo é ape- 
nas somar três números e mostrar o valor na tela. 


Utilizando o comando return em uma função 


O comando return devolve para o ponto de chamada da função o valor da 
variável ou expressão que aparece imediatamente após esse comando. Desse 
modo, podemos atribuir a uma variável (com o operador =) o valor retornado 
de uma função. 


Suponha que queremos imprimir uma variável do tipo string, mas com todas 
as letras maiúsculas. O PHP possui a função strtoupper, que transforma uma 
string em letras maiúsculas. Porém, dependendo da versão, esse comando não 
transforma caracteres acentuados. Uma opção para resolver esse problema seria 
a criação de uma função que recebe como argumento uma string e faz a trans- 
formação de todós os caracteres dessa string em maiúsculos. Acompanhe no 
exemplo a seguir como seria essa função: 


& exemplo6 2.php 


<?php 
function maiusculoCSstring) É 

$string = strtoupper ($string); 

$string = str.replace (“á", “A”, $string); 
$string = str.replace (é, “E”, $string); 
$string = str -replace CG", “f”, $string); 
$string = str replace (6%, “ó”, $string); 
$string = str replace CG", “ú”, $string): 
$string = str replace ("â", “A”, $string); 
$string = str.replace (“ê”, “E”, $string); 
$string = str replace (“6", “0”, $string); 
$string = str-replace (1º, “I”, $string); 
$string = str.replace (CO", “u”, $string); 
ôstring = str.replace (C&”, “A”, $string); 
$string = str.replaçe ('6", "6", $string); 


$string = str.replace (“ç", “g, $string): 


$string = str.replace (Cal, “A”, $string); 
return $string; 
} 
$nome = “José antônio”; 
fnome.m = maiusculo (Snome); 


echo “O nome do rapaz é Snome.m”; 
?> 


A execução do programa apresentado mostrará na tela o seguinte resultado: 


O nome do rapaz é JOSÉ ANTÔNIO 


Observe que o retorno da função foi atribuído à variável $&nome m, e depois 
esse valor foi mostrado na tela por meio do comando echo. No início da fun- 
ção utilizamos o comando strtoupper para transformar os caracteres não acen- 
tuados em maiúsculos. Para transformar os caracteres acentuados utilizamos o 
comando str replace, que faz a substituição de determinada parte da string 
por outro dentro de uma variável. Existem várias outras funções que traba- 
lham com strings, basta você consultar o manual do PHP para conhecê-las. 
Neste livro veremos às funções utilizadas com maior frequência. Observe a 
utilização do comando return dentro da função. Se ele não fosse colocado, a 
função não retornaria nenhum valor, e todas as alterações feitas durante sua 
execução seriam perdidas. 


O retorno de uma função não necessariamente deve ser atribuído a uma vari- 
ável. Ele pode ser colocado diretamente na saída de um comando de impres- 
são. Veja um exemplo no programa a seguir: 


& exemplo6 3.php 


<?php 


function triplo (numero) 


{ 
$x = $numero * 3; 
return $x; 

} 

şvalor = 5; 


“ 


echo “O triplo de $valor é * . triplolivalor); 


7» 


Uma função pode também, em vez de retornar um único valor, retornar um 
array contendo vários elementos. Veja a seguir um exemplo: 


& exemplo6 4.php 


<?php 


function clubes ( ) 


Í 
fclubes [ ] = “Grêmio”; 
$clubes [ ] = “Palmeiras”; 
$clubes [ ] = “Flamengo”; 
$clubes [ 1 = “atlético Mineiro”; 
felubes [ ] = “Bahia”; 
return Sclubes; 

} 


/í início do programa principal 

fnomes = clubes( ); 

for ($i=0 : $i < sizeof($nomes) ; $i++) 
{ 


echo “\Snomes [$1] vale $nomes[$i] <br>”; 


> 


Após a execução desse programa, o resultado será o seguinte: 
Snomes[0] vale Grêmio 
fnomes[1] vale Palmeiras 
fnomes[2] vale Flamengo 
$nomes[3] vale atlético Mineiro 


Snomes [4] vale Bahia 


Observe que a função clubes não recebe nenhum argumento, ela apenas é 
ativada e retorna um array para o ponto em que foi chamada: 


Veremos agora um exemplo de função envolvendo a data atual, Para isso utili- 
zaremos as funções time e getdate do PHP, A função time retorna o tempo 
corrente em número de segundos desde 1º de janeiro de 1970 (padrão Unix), 
e a função getdate transforma esse tempo em um array com o dia, mês, ano € 
outras informações sobre a data atual: 


& exemplo6 5.php 


<?php 
function retorna data ( ) 
{ 
$agora = time): 


$data = getdate(fagora); 
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iflSdatal"wday" ]e=0) { echo “Domingo, “13 
elseif($data[“wday"]==1) { echo “segunda-feira, “43 
elseif($data["wday"]==2) { echo “Terça-feira, “3 


elseif(Sdatal“wday']==3) { echo “Quarta-feira, "i } 
elseif($data["wday"]==4) { echo “Quinta-feira, “; 5 
elseif($data["wday"]==5) { echo “sexta-feira, "i } 


elseif($data["wday"]==6) { echo “Sábado, “; } 
ifCSdatal“mon"]==1) { $mes=" Janeiro"; } 

elseif($data["mon"]==2) { $mes="fevereiro"; } 
elseif($data[“mon"]==3) { $mes="Março"; } 
elseif($data["mon"]==4) { $mes="abri]": } 
elseif($data["mon"]==5) { $mes="Maio"; } 
elseif($data[“mon"]==7) { Smes="Julho”; } 


elseif(Sdata["mon"]==8) { $mes="Agosto"; } 


{ 

{ 

T 
elseif($data["mon" ]==6) { fmes="Junho”: } 

{ 

{ 

{ 


elseif($data{["mon"]==9) { $mes=" Setembro": } 


eiseifCSdatal“mon"]==10) { $mes="0utubro"; } 
elseif($data["mon"]==11) { $mes="Novembro"; } 
elseif($data["mon"]==12) { $mes=" Dezembro": } 


$data atual = $data["mday"].” de ".$mes." de “ Edatal"year"]: 


| 
| 
4 
: 
| 
| 


return $data atual; 
} 
thoje = retorna data ( ); 


echo Shoje; 


?> 


A execução desse programa imprimirá na tela o dia atual da semana, o dia do 
mês, o nome do mês e o ano atual, Por exemplo: 


Quarta-feira, 21 de Março de 2001 


Utilizando funções para verificar um CPF 


Outro exemplo em que as funções são bastante úteis é para verificar se um 
número de CPF foi digitado corretamente. Para isso existem diversas funções 
que fazem essa verificação com base no dígito verificador do CPF, Você en- 
contrará facilmente alguma se fizer uma busca na Internet. A seguir temos um 
exemplo de função que testa o número do CPF: 


€a exemplo6 6.php 


<?php 
function cpf.errado(Scpf) { 
Serro = false; 
faux.cpf = “”; 
for(Sj=0! Sjestrlen(Scpf);$j++) 
ifCsubstr($cpf,$),1)>="0" AND substr(Scpf,$),1)<="9') 
Saux. cpf .= substr(Scpf,$j,1): 
if(strien($aux cpf) !=11) 
Serro = true; 
else { 
Scpfl = faux cpf: 
$cpf2 = substr(Scpf,-2): 
fcontrole = “"; 
$start = 2; 
$end = 10; 
for($is1;$i<=2; $i++) { 
$soma = Q; 
for($j=$start; $j<=$end:$j++) 
O $soma += substr(Scpfl.($j-$1-1),1)*CSendel+Si-$3): 
if ($i==2) 
$soma += $digito * 2; 
$digito = ($soma * 10) % 11; 
ifCSdigito==10) 
Sdigito = 0; 
$controle .= $digito; 
$start = 3; 
$end = 11; 
} 
if($controle!l=$epf2) 
$erro = true; 


} 


return Serro; 


?> 


Um exemplo de utilização da função anterior seria o seguinte: 
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& exemplo6_7.php 


<?php 


if (cpf errado(Scpf)) 
{ 
echo "O CPE digitado é inválido"; 


exit; 


Po 


Se o CPF estiver correto, a função cpf errado retornará o valor false (falso), e 
os comandos dentro do if não serão executados. Se o CPF digitado estiver 
incorreto, será retornado o valor true (verdadeiro), fazendo com que o bloco 
de comandos do ifseja executado. Então será mostrada a mensagem “O CPF 
digitado é inválido”, e a execução do programa será finalizada pelo comando 
exit. 


f 
Imagine se não existisse o conceito de funções e você precisasse fazer a vali- 
dação de dois CPFs. O que fazer? Repetir duas vezes todo esse código para 
fazer uma verificação individual de cada CPF? Agora você já pôde perceber 
quais são os fatores que tornam importantes a utilização de funções em seus 
programas: a modularidade, a organização e a reutilização de código. 


Além de funções que verificam a validade de um número de CPF, também 
existem várias que verificam a validade do CGC de uma empresa. Na Web 
você também encontra essas funções prontas para download em diversos si- 
tes, por isso não é necessário que você perca tempo fazendo essa programa- 
ção. 


Passagem de parâmetros: valor e referência 


Quando passamos uma variável como argumento para uma função, por pa- 
drão estamos passando apenas o valor dela, e isso faz com que as alterações 
realizadas dentro da função não se reflitam sobre a variável quando terminar a 
execução da função. Ou seja, se uma função recebe como argumento a variá- 
vel $teste, que possui o valor 5, quando terminar a execução da função a vari- 
ável $teste continuará valendo 5, independentemente das alterações feitas 
dentro da função. Chamamos esse processo de passagem de parâmetros por 
valor, pois estamos passando apenas o valor da variável para ser utilizado na 
função. 
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Mas existem situações em que queremos que a variável a ser passada como 
argumento seja alterada conforme as alterações feitas durante a execução da 
função. Esse processo é chamado de passagem de parâmetros por referência. 
Esse tipo de passagem de parâmetros requer que seja colocado o símbolo & 
antes do nome da variável. Vamos ver alguns exemplos para entender melhor 
o funcionamento dos dois modos: 


& exemplo6 8.php 


<?php 
function dobro (Svalor) 
{ 


fvalor = 2 * $valor; 


} 
function duplica (&Svalor) 
{ 
$valor = 2 * $valor; 
} 
$valor = 5; 


dobro {$valor); 

echo $valor . “<br>”; 
duplica (Svalor): 
echo $valor; 


?> 


O resultado mostrado após a execução do programa será: 


5 
10 


isso ocorreu porque quando chamamos a função dobro, o valor calculado 
dentro da função se perdeu quando a execução retornou ao programa princi- 
pal. Quando chamamos a função duplica, a alteração feita dentro dessa função 
fez efeito na variável $valor, mantendo o novo valor mesmo quando ocorreu o 
término da função; ou seja, na função dobro fizemos uma passagem de parâ- 
metros por valor, e na função duplica fizemos uma passagem de parâmetros 
por referência, 


Quando utilizamos a passagem por referência, o que o PHP faz é simplesmen- 
te criar uma referência para a variável original, e isso faz com que as alterações 
sejam feitas diretamente na própria variável. Na passagem por valor é feita 
uma cópia do conteúdo da variável, e as alterações são feitas nessa cópia, não 
se refletindo na variável original. 
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Ainda sobre passagem de parâmetros, há uma característica do PHP que per- 
mite 4 definição de valores-padrão. Se uma função possui determinado parâ- 
metro e no momento da chamada esse parâmetro não é enviado, podemos 
utilizar valores-padrão. Para definir esses valores, basta colocar um operador 
de atribuição após o parâmetro definido na função, seguindo pelo valor que 
deve ser considerado o padrão. Veja um exemplo: 


& exemplo6. 9.php 


<?php 


function teste ($time , Sritulo = “Campeão Mundial") 


{ 
echo “O $time é $titulo <br>”; 
} 
teste ("flamengo" , “Campeão Carioca"); 
teste (“atlético” , “Campeão Mineiro”); 


teste ("Grêmio"); 


7> 


Após a execução desse programa o resultado será; 


O Flamengo é Campeão Carioca 
o atlérico é campeão Mineiro 


o Grêmio é Campeão Mundial 


Nas duas primeiras chamadas à função teste foram passados os dois parâme- 
tros necessários, mas na terceira chamada foi enviado apenas o primeiro parâ- 
metro, e isso fez com que o valor-padrão fosse assumido para o segundo parâ- 
metro. 


Uma observação importante sobre a utilização de valores-padrão é que esses 
devem ser sempre os últimos parâmetros definidos na função, Nunca deve- 
mos colocá-los na frente de outros parâmetros que não possuem um valor- 
padrão. Se uma função, por exemplo, possui três parâmetros, e um deles pos- 
sui um valor-padrão, não podemos colocá-lo como primeiro ou segundo pa- 
râmetro. 


Considere a seguinte função: 


function nada (Sa=10 , $b, $c) 
{ 
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Essa definição está errada, pois como o envio do parâmetro $a é opcional, 
poderíamos fazer a seguinte chamada: 


nada (1, 5); 


Isso causaria um erro, porque o PHP interpretará os dois parâmetros passados 
como $a e $b, e ocorreria um erro de execução devido à falta do parâmetro $c, 
Portanto, o modo correto de definir a função seria: 


function nada ($b, $c, $a=10) 
{ 


) 


Dessa forma, poderíamos fazer a chamada nada(1, 5), fazendo com que $a, $b 
e $c recebam os valores 10, 1 e 5, respectivamente. 


Funções recursivas 


Chamamos de funções recursivas aquelas funções que chamam a elas mes- 
mas. Veja um exemplo simples desse tipo de função: 


Es exemplo6 10.php 


<?php 
function teste ($valor) 
{ 
if ($valori=0) 
{ 
echo “Foi chamada a função teste passando o valor $valor <br>"; 


teste CSvalor-1): 


} 
teste (7); 


7> 


O resultado gerado pela execução do programa será o seguinte: 


Foi chamada a função teste passando o valor 


Foi chamada a função teste passando o valor 


Foi chamada 


função teste passando o valor 


a 

Foi chamada a 

Foi chamada a função teste passando o valor 
a 


Foi chamada a função teste passando o valer 


ein ar e A 4 


o 
o 
o 
função teste passando o valor 
o 
o 
o 


Foi chamada a função teste passando o valor 
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O que ocorreu foi que a cada chamada da função teste, O valor passado era 
mostrado na tela e logo em seguida era feita uma nova chamada para essa 
função, mas passando o valor antecedente. Com isso fomos formando uma 
pilha de chamadas à função teste. Quando a variável $valor atingiu O valor 
zero, ocorreu o desempilhamento de chamadas, e as funções em aberto foram 
terminando, cada uma devolvendo o controle para quem a chamou. 


Umas das funções recursivas mais conhecidas é aquela que faz o cálculo do 
fatorial de um número. Se você não lembra bem o que é o fatorial, veja alguns 
exemplos: 


4l = 4,32.) = 24 


3 =3.2.1=6 
2l = 2Zls2? 
1 = à 

01 = d 


O fatorial de um número n é calculado por meio de n multiplicações, envol- 
vendo o próprio número e os antecessores a ele. Por convenção, O fatorial do 
número 0 vale 1. A função fatorial poderia ser definida da seguinte maneira: 


exemplo6. 1.php 


<?php 
function fatorial ($numero) 
{ 
if CSnumero<0) 
{ return ~l; } 
if CGnumero<=1) 
{ return 1; 5 
return fnumero*fatoria! (Snumero-1); 
} 
echo “O fatorial de 3 é ” . fatorial (G3); 
echo “<br>0 fatorial de 4 é ” . fatorial(4); 
echo “<br>o fatorial de 5 é". fatorial(5): 


?> 


O primeiro teste realizado testa se O número passado como argumento não é 
negativo, pois não existe fatorial de números negativos. Caso isso ocorra, a 
função retorna o valor -1. Se o número passado como argumento for maior 
que 1, é feita a multiplicação do valor corrente pelo fatorial do número ante- 
cessor, que se obtém fazendo uma nova chamada para a função fatorial, Ai está 
a recursividade! 
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As chamadas serão empilhadas, e quando o valor passado como argumento se 
tornar menor ou igual a 1 é feito o caminho de volta, ou seja, as chamadas são 
retiradas da pilha e os valores calculados são retornados, até chegar no primei- 
ro ponto do programa que realizou a chamada, retornando o valor do fatorial 
do número. Na chamada do fatorial de 5, por exemplo, foram feitas as seguin- 
tes chamadas: 


Chamada Retorno 


1 5 *fatorial(4) 
2 4 * fatorial(3) 
3 3 * fatorial(z) 
4 2 * fatorial(!) 
5º 1 


O valor de retorno da 5º chamada é utilizado na 4º. O valor de retorno da 4º 
chamada é utilizado na 3º, e assim por diante. 


Reutilizando funções 


Imagine que seu site possui cerca de 50 páginas, e existe uma função que você 
utiliza em todas elas. Você não precisa repetir o código dessa função em cada 
uma das páginas. Se você fizesse isso, existiriam 50 funções iguais em seu site, 
e o pior, se fosse necessário fazer alguma alteração na função, você teria de 
alterar em todas as páginas, 


Um exemplo que pode ser citado é a exibição da data atual, Se você quisesse 
trocar O formato de exibição da data, seria interessante alterar apenas um ar- 
quivo, e assim as demais páginas seriam também automaticamente alteradas. 


Para que possamos reutilizar uma função em diversas páginas, existe o co- 
mando include, que veremos com detalhes mais adiante. 


Definição de classe 


Se você já programou em alguma linguagem orientada a objetos, você deve ter 
uma noção desse conceito. Classes são agrupamentos de variáveis e funções. 
Uma classe é utilizada para descrever um objeto. Um objeto poderá utilizar 
todas as variáveis e funções existentes em sua classe, Veja O exemplo de uma 


classe que podemos definir para trabalhar com as características de um aparta- 
mento. 
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Classe apartamento 


Propriedades: 


* numero quartos 

+ numero banheiros 
e preco aluguel 

* preco. venda 

* tamanho 


* localizaçao 


Essas propriedades são atributos da classe apartamento, que poderão ser utili- 
zados quando criarmos um objeto para essa classe, 


Como criar uma classe 


A sintaxe é a seguinte: 
class nome.ciasse 


{ 


<procedimentos> 
} 


Uma classe pode conter várias funções e variáveis, Para criar variáveis dentro 
de uma classe, usamos a instrução var. Dentro das classes, podemos também 
utilizar a variável $this, que é uma variável interna do PHP responsável por 
referenciar o objeto utilizado. 


Para criar um objeto de determinada classe, devemos atribuir à variável que 
representará o objeto a instrução new seguida do nome da classe. Para acessar 
valores de um array dentro de uma classe, devemos utilizar o simbolo ->, se- 
guido do nome do array com chave associativa desejada. 


Veremos agora um exemplo de uma classe chamada Loja, que faz o controle 
dos artigos disponíveis, possibilitando inclusive controlar a inserção ou remo- 
ção de novos artigos por meio de funções definidas internamente. Veja o exem- 
plo a seguir: 


ga exemplo6. 12.php 


<?php 
class Loja 
{ 


| 
| 
| 
| 


var $itens; 
function adiciona (Scodigo, Squantidade) { 
ifCisset(Sthis->itens [Scodigol)) 
$this->itens[ Scodigo] += fquantidade; 
else 


$this->itensL codigo] = fquantidade; 


} 
function remove ($codigo, $quantidade) 
{ 
if ($this->itens[$codigo] > Squantidade) 
{ 
$this->itens[$codigo] -= fquantidade; 
return true; 
} 
else 
{ 
return false; 
} 
} 


} - 
Sestoque = new Loja; 


?» 


A classe Loja possui como variável o array itens que foi declarado no início 
com o uso da instrução var. Além disso, existem duas funções que têm por 
objetivo acrescentar ou remover itens do estoque. O objeto é criado no mo- 
mento que fazemos a atribuição de new Loja à variável $estoque. A partir des- 
se momento o objeto Sestoque já pode acessar as variáveis e funções disponí- 
veis na classe, Veja um exemplo em que esse acesso é feito: 


& exemplo6  13.php 
<?php 
Sestoque->adiciona(“bermuda”,2); 
Sestogue->adiciona(“camiseta”,3); 


echo “A loja já possui “ . Sestoque->itens[“bermuda”] . “ bermudas.<br>"; 


echo “A Toja já possui " , Sestoque->itens[“camiseta”] . “ camisetas.<br>”; 
J 


?> 
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A execução desse trecho de programa gerará o seguinte resultado: 


A loja já possui 2 bermudas. 


A loja já possui 3 camisetas. 


Note que utilizamos o símbolo -> para acessar funções e variáveis da classe 
loja. Esse é o símbolo que você deve utilizar sempre que estiver trabalhando 
com objetos. 


Programação orientada a objetos no PHP 5 


Uma das principais mudanças da versão 5 do PHP consiste no amadurecimen- 
to da linguagem no que diz respeito à programação orientada a objetos (OOP). 
A partir dessa versão, o PHP passa a operar com a Zend Engine 2.0, utilizando 
um novo modelo de objetos, Esse modelo deve conferir ao PHP, em termos de 
OOP, significativos ganhos de velocidade e performance, visto que ele é mais 
otimizado e realiza muito menos cópias redundantes de dados, como ocorria 
no modelo antigo. 


A seguir são apresentadas algumas das novas características da QOP existen- 
tes no PHP 5. Para obter mais informações sobre essas e outras alterações na 
OOP, consulte o site oficial do PHP (http://www. php.ned, onde está disponi- 
vel uma página que lista as características da Zend Engine 2. 


As palavras-chave private e protected 


Utilizando as palavras “private e protected podemos criar métodos ou váriá- 
veis privadas e protegidas em uma classe. Uma variável privada só poderá ser 
acessada pela própria classe onde ela foi declarada, enquanto que uma variá- 
vel protegida poderá ser acessada também pelas subclasses da classe onde ela 
foi declarada. Veja um exemplo. 


& exemplos 14.php 


<?php 
class Classel { 
private $varl = “Olá, varli\n”; 
protected $var2 = “olá, varzhn"; 
protected $var3 = “olá, var3hn”: 
function bombiaO) | 
print “Classel: “, Sthis->varl. “<br>"; 


i 


print “Classel: “. $this->var2. “<br>”; 


i 


print “Classel: “, $this->var3, “ebro<br>": 


| 
| 
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tr iaaeaie 


class Classe? extends Classel É 
function bompiãO { 


classel: :bomDiaO; 


print “Classez: ". $this->varã. 


print “classeZ: “. fthis->vara. 


print “ClasseZ: “. 


É) 
É 
Sobj = new ClasselQ; 
Sabj->bombia O; 
Sobj = new Classe? (); 


Sobj->bomDia O; 


?> 


fthis->var3, 


ae 


// Exibe 


“ebro": // não exibe nada 
“coro; // Exibe 


“<br>”; // Exibe 


Nesse exemplo, a Classe2 toi declarada como subclasse da Classel. A variável 
gvari foi declarada como privada (private), e portanto ela só poderá ser aces- 
sada pela própria Classe1, As variáveis $var2 e $var3 são protegidas (protec- 
ted), e portanto podem ser acessadas pela subclasse Classez. - 


b 


Uma classe pode conter também métodos privados ou protegidos. Por exemplo: 


& exemplo6. 15.php 


<?php 
class Classel { 


private function Metodoprivado O) { 


echo “classel::MetodoPrivado() chamado. <br>”; 


} 


protected function MetodoProtegidoQ) { 


echo “Classel: :Metodoprotegido() chamado. <br>"; 


$this->Metodoprivado(); 


} 
class Classe? extends Classel { 


public function metodopublicoO { 


echo “Classe?: :Metodopublico() chamado. <br>"; 


$this->MetodoProtegidoO; 


} 
$obj = new Classe2; 


$obj->MetodoPublico(); 


> 
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Nesse exemplo, foi criado um objeto para a subclasse Classe2, e foi chamado o 
método MetodoPublicoO. Esse método chama o MetodoProtegidoo de sua 
superciasse, que por sua vez chama o MetodoPrivadoO. Uma chamada direta 
da Classe2 ao método privado não iria funcionar. 


Métodos abstratos e interfaces 


No PHP 5 é possível criar métodos abstratos, Isso significa que o método é 
apenas declarado, mas sua implementação não é fornecida, Isso será feito poste- 
riormente em outra classe. Por exemplo: 


& exemplo6 16.php 


<?php 

abstract class Classeabstrata { 
abstract public function testeO; 

} 

class Classeimplementacao extends Classeabstrata { 
public function teste { 


echo “Método teste() chamado! <br>": 


} 
$obj = new ClasseImplementacao; 


Sobj-steste O; 


7> 


Veja que a classe que contém o método abstrato também deve ser definida 
como abstrata, e não poderá ser utilizada para criar objetos diretamente. 


No PHP 5 também temos a possibilidade de criar interfaces. Nelas, inserimos 
apenas as declarações dos métodos que farão parte da classe que irá imple- 
mentá-la, É um recurso semelhantes às classes abstratas. Uma das diferenças é 
que uma classe pode implementar diversas interfaces. Utilizamos a palavra 
reservada implements para indicar que uma classe implementa uma determi- 
nada interface. Exemplo: 


<?php 


interface Minhainterface { | 


public function TesteO; , 
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class MinhaClasse implements minhainterface { 
public function Teste) É 
FÊ eo 


?» 


A palavra-chave final 


Os métodos que forem declarados com a palavra final não poderão ser sobres- 
critos pelas subclasses. Exemplo: 


<?php 
class Minhaclasse { 
final function TesteO É 
E ess 


} 


2> 


Nesse exemplo, se fosse deciarado um método com o nome Teste em uma 
subclasse de MinhaClasse, ele não iria sobrescrever o método declarado como 
final. Também é possível declarar uma classe como final Exemplo: 


<?php 

final class Minhaclasse { 
/! 

} 


?> 
Isso significa que ela não poderá ter subclasses. Portanto, a linha de código 
apresentada a seguir não iria funcionar. 


class Qutraclasse extends Minhaclasse {} 


Construtores e destrutores 


Um construtor consiste em um método que será chamado toda vez que for 
criado um objeto da classe onde ele foi declarado. Portanto, pode ser utilizado 
para inicializar um objeto antes dele ser usado. Ao contrário das versões ante- 
riores, onde o construtor deveria possuir o mesmo nome da classe, no PHP 5 
esse método deve ser criado com o nome .. constructQ. Por exemplo: 


sm exemplo6 17.php 


<?php 
class Classe { 
function o LONStruCtO { 
print “Este é o contrutor da Classe<br>": 


+ 
class SubClasse extends Classe { 
function ..constructO { 
parent: i construct); 
print “Este é o contrutor da Subclasse<br>”: 


} 
$obj = new Classe(); 


$obj = new subclasse); 
7> 


A vantagem dessa mudança é que, se a segunda classe tivesse que ser movida 
para ser subclasse de alguma outra, não haveria a necessidade de alterar o seu 
código, já que todos os construtores estariam nomeados como  constructo), 
Por questões de compatibilidade, se o PHP não encontrar o método . cons- 
tructQ ele irá procurar por um método que possua o mesmo nome da classe, 


Além de um construtor, uma classe pode ter também um destrutor, que deve 
ser nomeado como — destructO. Um destrutor é O método que será chamado 
após a última referência feita a um objeto no programa, antes da liberação da 
memória, Veja o exemplo a seguir: 


& exemplo6 18.php 


<?php 
class Minhaclasse ( 
function ..constructO { 
Sthis->nome = “MinhaClasse"; 
print “Este é o construtor da classe ", Sthis->nome, “<br”: 
} 
function ..destructO { 


print “Este é o destrutor da classe *, Sthis->nome: 


} 
$obj = new MinhaclasseO); 
?> 


Um destrutor pode ser útil para fins de depuração, fechamento de conexão 
com banco de dados, entre outras tarefas, 


Variáveis e métodos estáticos 


As variáveis estáticas (precedidas pela palavra static) agora podem ser iniciali- 
zadas, como mostra o exemplo a seguir, 


& exemplo6 19.php 


<?php 
class Classe { 

static $variavel estatica = 10; 
4 


print Classe: : fvariavel estatica; 


T> 


Além disso, no PHP 5 a palavra static também pode ser utilizada para definir 
um método como estático. Dessa forma, é possivel chamá-lo mesmo sem a 
criação de um objeto para a classe onde ele foi declarado. Exemplo: 


<?php 
class Classe { 


public static function MetodoEstaticoO É 


PÉ era 


} 
Classe: :MetodoEstatico(); 


T> 
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Utilizando includes em PHP 


As includes são uma excelente opção oferecida pelo PHP. Elas nos permitem 
reaproveitar uma ou mais funções ou arquivos, utilizando-os em diversas pá- 
ginas do site. As situações em que as includes são mais usadas são aquelas em 
que uma alteração deve ser refletida em todas as páginas do site automatica- 
mente, e para isso precisamos alterar apenas um arquivo, que será acessado 
por todas as páginas. 


Criando um menu para seu site 


No início deste livro foi exposta a seguinte situação: imagine um site que pos- 
sui cerca de 100 páginas, e que no lado esquerdo das páginas há um menu 
com links para as seções do site. Se alguma seção for incluída ou excluída, 
como fazer para atualizar as 100 páginas, incluindo ou excluindo esse novo 
link? Alterar manualmente as 100 páginas? Pois bem... chegou a hora de conhe- 
cermos a solução para esse problema, 


Vamos supor que temos um site especialista em informações sobre cinema, 
que possui as seguintes seções: Em Cartaz, Destaques, Em Breve, Trilha Sono- 
ra, Ranking, Trailer, Bilheteria, Programação, Galeria de Fotos, Links, Arquivo 
e Opinião, conforme mostrado na figura 7.1. 


O menu que você vê no lado esquerdo da página é o mesmo utilizado em 
todas as páginas do site, para que o visitante possa acessar a seção desejada a 
partir de qualquer página. Suponha que o nome da página apresentada seja 
index. php. 


Só que agora resolvemos incluir uma nova seção no site: a seção “Crítica”. Não 
ramos alterar individualmente cada uma das páginas, pois com certeza estare- 
mos utilizando esse menu como uma include. 
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Ċinema Online 


seções Lorem iprum dolor st amet, conpeciemer adipisting 
elt, sed dem nonummy nih eismod tincidnt ut 
BARARLSZ diem nonameny mbh rusmod lacreet dolore magna aliguam erat volupar Ui wisis 
idoni ut lacreet dolore magar enim ad mitma venam, quis nostrud exerci tution 
MST Amis s erat volutpat, U} wisis ufamcorper suscipit lobortis nist ut aliquip ex ca 
EMBRESE ad minm veniam, quis comemado consequat, Emis te feugfaciisi Duis 
strud expect tuton ulameorper antem defor in hendrerg m vulputats velit esse 
TRILHA SONORA cipi lobortis msl ut aliguip ex molesse consequar, vel iun dolore eu Feugiat mula 
sa commodo consequat. facilisis at vero eros et accumsan et pasto odio 
BARKIS PERETE dignes qui blandt prasseni hiptatwn goni delent ay 
ati, fuel 
TANE Part Selic: Di ate dolo ibakara, MS ore de Prugar neo ain: 
atoa vulpntets vekt efon brolagte conisoquas, vel akan Th wani enin ad minim venam, quis nosirud exerci 
RUREKEBS dolore eu feugiat solla faciirie dE oro Toret taion vlsmcorper suscipi loborta masi ut abquep ex en 
PROGRAMAÇÃO accumean vt iusto odio dignissira qui blanda praesent comodo consequas. Dius te feugifacilisi per suscipë 
kaptata sent delenit au gue duis dolore te feugat Job arti us ab ER PA corvando 
ratos sulla facisi. consequat Lorem ipsia dolor sit amet, conseçtetser 
x i ; E adipiscing els, sed diem nonummy aih euismod 
Ut vim enim ad minim veniam, quis nostrud exert : i a 
kag taon ulamcorper suscipi lobortis nisi ut aiqup ex em kerar, 1 latecot dolore maska Apinn erat 
ARSSO commodo consequal. Duis te feugifacilisi pes suscipit i 
loborhe msi 4 aliqup ex en commodo 
RWA consequat Lorem iprum dolor sit amet, consectetuer 
adipiscing ekt, sed diem nonurany nibh maimed 
tincidunt ut lacrest dolore magna aliguam èra? 
volutpat. 


Figura 7.1 — Site de cinema dividido em seções. 


A função include tem por objetivo incluir um arquivo dentro de outro, e sua 
sintaxe é a seguinte: 


include “nome do arquivo”, 


Então vamos transformar esse menu em uma include! Para isso devemos reali- 
zar quatro passos importantes: 


D identificar no código HTML onde está o menu; 


2) retirar esse código HTML da página (pode ser com as teclas CTRL+53, abrir 
um novo arquivo e colar esse código no novo arquivo aberto (CTRL+C), 


3) salvar esse novo arquivo como mMenu ing 
4) no lugar de onde voçê retirou o código do menu, coloque uma chamada 
para a include entre as tags do PHP: 


<?php include “menu,incl; 7> 


No caso desse nosso site de cinema, veja como ficaria O arquivo menu inc 
«font size="2º> 


<p><strong>Seções<br></streng></p> 


«p><a href=" cartaz. php”>EM CARTAZ</a></p> 
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<p><a href="destaques.php'>DESTAQUES</a»</p> 
<p><a href="breve php">EM BREVE</a></p> 

<p><a href="trilha.php">TRILHA SONORA</a></p> 
<p><a href="ranking.php”>RANKING</a></p> 

<p><a href=“trailer. php'>TRAILER</a></p> 

<p><a href="bilheteria.php">BILHETERIA</a></p> 
<p><a href="programacao. php">PROGRAMAÇÃO</a></p> 
<p><a href="fotos. php">FoTOS</a></p> 

<p><a href=" Vinks .php'>LINKS</a></p> 

<p><a href="arguivo.php">ARQUIVO</a></p> 

<p><a href="opiniao. php">ÓPINIÃO</a></p> 
</font> 


O arquivo menu.inc seria uma include que contém os comandos HTML para 
formar o menu principal do site. Portanto, em todas as páginas do site, no local 
onde deve constar o menu, aparecerá uma chamada para a include: 


<?php include “menu inc”; 7> 


Mas lembre-se de que todas as páginas que utilizam includes devem possuir 
extensão .php, pois elas executam comandos da linguagem. 


Pronto! Agora ficou bem mais fácil incluir, alterar ou excluir novas seções no 
site, pois temos o menu em um único arquivo que é acessado por todas as 
páginas. Em nosso site de cinema, para incluir a seção “Crítica”, bastaria abrir o 
arquivo menu.inc e acrescentar a seguinte linha: 


<p><a href="critica.php'>CRÍTICA</a></p> 


Do mesmo modo que criamos um menu lateral por meio de uma include, 
podemos criar um cabeçalho e um rodapé-padrão, incluindo o logotipo do 
site, o banner de um patrocinador, direitos autorais, links adicionais etc. Para 
isso primeiro você deve criar, por exemplo, os arquivos cabecalho.inc e 
rodape.inc, e dentro deles incluir o conteúdo que você desejar. Depois basta 
incluir em cada página, no topo e no rodapé, as chamadas para os dois arqui- 
vos criados: 


<?php include “cabecalho.inc”; ?> 


<?php include “rodape.inc”; P> 


Agora acabou seu sofrimento! Nunca mais você precisará alterar uma a uma 
todas as páginas de seu site. 


Exibindo a data atual com uma include 


É muito comum hoje em dia a apresentação da data atual nas páginas de um 
site. Podemos criar uma include que mostre a data atual, e chamá-la de todas 
as páginas em que é necessária a exibição da data. Essa include poderia ser 
feita da seguinte maneira: 


& data.inc 


<?php 


meses = array (“Janeiro”, “Fevereiro”, “Março”, “abril”, “Maio”, “Junho”, 
y ç : 
“Julho”, “agosto”, “setembro”, “Outubro”, “Novembro”, “Dezembro"): 


$dia = date (“d”, time( 5); 
Smes = date Cm”, time( )); 
Sano = date (Cy”, time( )); 


echo $dia . “ de", Smeses [$mes-1] . “ de". Sano; 
7> 


Construímos um array com os nomes de todos os meses, e logo após utiliza- 
mos a função date do PHP para obter os valores atuais do dia, mês e ano, O 
comando date retorna o valor numérico do mês, e nós utilizamos esse valor 
decrementado (pois o array começa em 0) como índice para acessar o array 
dos meses, O ano será mostrado com 4 dígitos, pois utilizamos o “Y” maiúscu- 
lo, O “Y” minúsculo retorna o ano em 2 dígitos apenas. 


Salvando o programa acima como data.inc, você terá sua include pronta. O 
próximo passo é colocar as chamadas para essa include nas páginas em que a 
data deve aparecer: 


<?php include "data inc”; 7> 


Quando a include é ativada, a data atual é mostrada na tela, no formato que 
especificamos quando utilizamos o comando echo. Exemplo: 


22 de Março de 2001 


Reutilização de código 


Dentro das includes também podemos definir funções, e essas funções esta- 
rão disponíveis para todas as páginas que chamarem a include, Dessa forma 
estamos reutilizando o código das funções, em vez de escrevê-lo novamente. 
Já vimos anteriormente uma função que converte uma string em letras maiús- 
culas, alterando caracteres acentuados e não-acentuados, Vimos também uma 
função que faz a validação de um número de CPF digitado. Se precisássemos 


e 
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utilizar essas funções em outras páginas, bastaria colocá-las dentro de uma 
include, e no início das páginas colocar uma chamada para essa include, 


Se colocássemos essas duas funções dentro de uma include chamada 
funcoes aux.inc, poderíamos utilizá-las nas páginas da seguinte maneira: 


<?php include “funcoes aux, inc”; ?> 
<html> 


<body> 


<?php 
nome = maiusculo (nome); 
if Cepf.errado(Scpf)) 
{ echo “O CPF digitado é inválido"; } 
?> 
«</body> 
</html> 


Include x Require 


Além do comando include, existe também o comando require. Os dois co- 
mandos têm a mesma função, mas possuem uma pequena diferença: o co- 
mando include é reavaliado a cada chamada, ou seja, uma mesma instrução 
include pode incluir vários arquivos (por meio de um laço, por exemplo); 
enquanto a instrução require pode incluir apenas um arquivo. 


Suponha que temos um array com o nome de todos os arquivos que devem 
ser incluídos durante a execução da página, como é mostrado a seguir: 


Sincluir = array (“funcoes aux. inc” , “cabecalho.inc”, “data.inc'); 


Para realizar a inclusão desses arquivos, resolvemos fazer um laço com o co- 
mando for 


for ($i=0 + Sissizeof(Sincluir) ; $i++) 
{ 
require “'$incluir[$i]"; 


} 


Executando esse laço, o único arquivo que será incluído é o funçoes aux.inc. 
Os arquivos cabecalho.inc e data.inc não serão incluídos, pois a função requi- 
re não inclui arquivos dinamicamente. 


Para resolver esse problema, devemos utilizar a função include no lugar da 
função require, pois a cada iteração do laço a função include é reavaliada, 
Portanto, o correto seria escrever o programa da seguinte maneira: 
for ($i=0 ; $i<sizeof($incluir) ; $i++) 
T 
include "'$incluir[$1]"; 


} 


Uma observação importante sobre o comando include é que quando utilizado 
com comandos condicionais ele deve sempre aparecer entre chaves, pois ge- 
ralmente uma include executa mais de um comando. Exemplo; 


<?php 
if ($op==1) 
{ include “menul inc"; } 
elseif (Sop==2) 
{ include “menuZ inc”; } 
else 


{ include “menu3 inc”; } 


?> 


Capítulo 8 
PHP e formulários HTML 


Talvez esta seja uma das principais razões que levou você a adquirir este livro: 
como criar um formulário para os usuários de meu site preencherem? Como 
faço para enviar essas informações para o meu programa PHP? E como devo 
tatá-las dentro do meu programa? Chegou a hora de conhecer as respostas 
para todas essas perguntas. Após a leitura deste tópico, você estará pronto 
para criar formulários que deixarão seu site muito mais interativo. 


Como criar um formulário 


Os formulários são criados por meio da linguagem HTML, que você já deve 
conhecer bem. Um formulário é composto de no mínimo um campo para en- 
trada de dados, e um botão para enviar as informações contidas nele. Veja um 
exemplo de formulário: 


Figura 8.1 — Exemplo de formulário HTML. 


O código HTML para esse formulário é o seguinte; 
<form» 
<p>Digite seu e-mail: <input type="text” name= emait” size="20"»</p> 
<p><input type="submit” value="Enviar!” names"enviar">«/p> 
</form> 


Desenvolvendo Websites com PHP 


Se você clicar no botão “Enviar!” desse formulário, o valor que foi preenchido 
no campo e-mail não será enviado a lugar nenhum, pois seu browser não sabe 
para onde enviar as informações. Portanto, o formulário definido anteriormente 
não tem nenhuma utilidade, pois perdemos as informações quando clicamos 
no botão “Enviar”. 


Para tornar esse formulário útil, devemos informat ao browser para onde de- 
vem ser enviadas as informações, Você utilizará os formulários para enviar dados 
aos seus programas PHP, então o correto é informar ao browser qual progra- 
ma receberá esses dados. Isso é feito com a opção action, utilizada na tag form 
do HTML. Veja o exemplo a seguir: 


<form action=" recebe dados, php”> 
<p>Digite seu e-mail: <input type="text” name="emaj}" size=s"20"></p> 
<p><input type="submit” value="Enviar!” name="enviar" ></p> 


</form> 


Agora quando você clicar no botão “Enviar!”, o conteúdo do campo e-mail 
será enviado ao programa recebe_dados.php, e esse programa tratará a infor- 
mação recebida, Só falta você criar o programa especificado, e nele fazer o 
processamento das informações do modo que achar melhor. 


Observe que para definir um campo de entrada de dados utilizamos a tag 
input. Essa tag pode vir acompanhada de diversas opções, Vamos ver as 
principais: 


Opção Descrição 

name informa qual é o nome do campo, = nnn 
value informa um valor padrão para o campo, 

size Informa o tamanho do campo exibido na tela. 

maxlength Informa o número máximo de caracteres que pode ser digitado no campo. 
type informa qual é o tipo do campo de entrada de dados. 


Os valores possíveis para a opção type da tag input são mostrados na tabela a 
seguir; 


Valor Descrição 

text Mostra uma caixa de texto de uma linha, e permite a entrada de valores 
numéricos ou alfanuméricos, 

password Utilizado para a digitação de senhas, São mostrados asteriscos (*) no lugar 
dos caracteres digitados, mas a informação é enviada normalmente. 

hidden É um campo escondido, Não aparece na tela. Podemos utilizá-lo para 


passar informações aos programas que recebem os dados. Veremos mais 
adiante que esses campos são de grande utilidade. 
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select 
checkbox 
radio 


textarea 
file 
submit 
image 


reset 


Descrição (continuação) 


Exibe uma caixa de seleção, que pode ser marcada ou desmarcada. 


São botões de seleção, em que o usuário escolhe uma entre várias opções 
disponíveis. 


Caixa de texto com várias linhas. 
Permite o envio de arquivos. 
Botão que aciona o envio dos dados do formulário. 


Temamesma função que o submit, mas utiliza uma imagem em vez do botão 
tradicional do formulário. 


Limpa todos os campos de um formulário e retorna ao valor-padrão (se 
existir). 


Veja na figura 8.2 um exemplo de formulário que utiliza diversos tipos de cam- 


pos: 


io que você achou do site? 


& Muito Bom C Bom C Regular C Um Lixo 


Qual a seção que você mais gostou? 


Em Cartaz É Outra) 


Digite seus comentários no espaço abaixo: 


Diga-nos coma entrar em contato com você: 


Figura 8.2 — Formulário HTML com diferentes tipos de campos. 


O código HTML para esse formulário é o seguinte: 
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<form action=" processa, php”> 

«prestrong>0 que você achou do site?</strong> 

«<«di><dd> 

<input type="radio” name=s"avaliacao” values"muitobom” checked>Muito Bom 
<input types"radio” name="avaliacao” value="bom>Bom 


<input type="radio" name="avaliacao” value="regular">Regular 


<input type="radio” name="avaliacao” value="umlixo">Um Lixo 
«fdd></dis 
<«p><strongsQual a seção que você mais gostou?</strong> 
<di><dd> 
<select name="secao” size="1"> 
<option value="emcartaz”>Em Cartaz</option> 
<option values"trilhasonora">Trilha Sonora</option> 
<option value="fotos'"sGaleria de Fotos</option> 
<option value=s"bi lheteria">Bilheteria</option> 
<option value="outra”>0utra</option> 
</select> 
outra: <input type="text”. sizes"26" maxTength="256" name=s"outra”> 
«fdds</di> 
«p>e<strong>Digite seus comentários no espaço abaixo: </strong> 
<di><dd> 
<textarea name="Comentarios” rows="5" cols="42></textarea> 
</dds</dl> 
<p><strong>Diga-nos como entrar em contato com você: </strong> 
<«di> <dd> 
<pre> 
Nome <input type="text” size="35" maxlength="256" name=" nome"> 


E-mail <input type="text” size="35" maxlength="256" names" emai] "> 


Fone <input type="text” size="35" maxlength="256" name=" fone"> 
FAX <input type="text” size="35" maxlength="256" name=” fax”> 
</pre> 

</dd></di> 

<«dis<dd> 


<input type="checkbox” name="novidades” values"nov'> 
quero receber as novidades do site por e-mail 
</dd></dl> 

<p><input type="submit” value="Enviar Dados”> 

<input type="reset” value="Limpar Formulário"></p> 


</form> 
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Enviando as informações para um programa PHP 


Vimos no tópico anterior que para especificar qual programa PHP receberá os 
dados do formulário utilizamos a opção action da tag form do HTML, Exem- 
plo: 


<form action="processa dados, php"> 


Resta saber como esses dados são passados ao programa PHP, Existem dois 
métodos de passagem de parâmetros: GET e POST. No caso de um formulário, 
o tipo de método a ser utilizado é especificado na opção method da tag form. 
Exemplo: 


<form action="processa dados. php” method="POST"> 


Yamos ver com detalhes cada um deles para que você entenda a diferença. 


Método GET 


Esse é o método-padrão para o envio de dados. Se no momento da criação de 
um formulário nenhum método for especificado na opção method da tag form, 
estaremos utilizando o método GET para o envio dos dados. 


Nesse método, os dados serão enviados juntamente com o nome da página 
(na URL) que processará os dados recebidos. Considere o seguinte formulário 
como exemplo: 


<form action="recebe. dados. php"> 
«p>Digite seu nome: <input type="text” names"nome” size="30"></p> 
<p>Digite sua idade: <input type="text" names"idade” sizes" 3'></p> 
<p><input type="submit" value="Enviar!” name="enviar'></p> 


«</form> 


Note que esse formulário não mostra a opção method, portanto o padrão é 
adotado (method="GET”). Suponha que preenchemos o campo nome com o 
valor Joaquim, e O campo idade com o valor 20. Logo após clicarmos no botão 
“Enviar”, o endereço ativado será o seguinte: 


http://www. seusite,com,br/recebe. dados. php?nome=Joaquimãi dade=20 


Os campos do formulário serão passados como parâmetros após o endereço 
de destino. O caractere ? representa o início de uma cadeia de variáveis, e o 
símbolo & identifica o início de uma nova variável. As variáveis e seus respec- 
tivos valóres são separadas pelo caractere =, 
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Existem alguns inconvenientes de utilizar o método GET Primeiramente por- 
que há um limite de caracteres que podem ser enviados (em torno de 2,000 
caracteres). Outro problema é que o usuário enxergará todos os parâmetros 
por meio da barra de endereço do browser, o que não é muito agradável, Para 
resolver esses problemas existe o método POST. 


Em compensação, o método GET possui uma grande vantagem: além de envi- 
ar informações via formulários, esse método pode ser utilizado também para a 
passagem de parâmetros por meio de links. Imagine, por exemplo, uma loja 
virtual, onde há um link para cada produto. Certamente cada link passa como 
parâmetro um número identificador do produto, para ser tratado por determi- 
nado programa, O link para um produto específico poderia ser o seguinte; 


http://www, tojinhadojoao.com.br/produto.php?id.produto=50 


Dessa forma, um programa chamado produto. php receberia o número identi- 
ficador do produto e realizaria uma consulta ao banco de dados para buscar 
informações detalhadas, como descrição, preço etc. Podemos, se necessário, 
passar mais de um parâmetro através do método GET. Para isso basta utilizar o 
simbolo & fazendo a separação, Por exemplo, o link para consulta de uma 
subcategoria da loja poderia ser o seguinte: 


hetp://mww. lojinhadojoao.com.br/produto. php?categorias2&subcategoria=5 


Somente com o método GET podemos passar parâmetros por links. O méto- 
do POST trabalha somente com formulários. 


Método POST 


Para utilizar o método POST devemos utilizar opção method da tag form para 
informar ao browser. Exemplo: 


<form action="recebe, dados. php” method="PosT"> 
<p>Digite seu nome: <input type="text” name="nome” size="30"></p> 
<p>rDigite sua idade: <input type="text” name="idade” size="3"></p> 
<p><input type="submit” value="Enviar!” name="enviar's</p> 
</form> 
Ao contrário do método GET, que envia os dados por uma cadeia de variáveis 
após o endereço-destino, o método POST envia os dados do formulário por 
meio do corpo da mensagem encaminhada ao servidor, 


Como os dados são enviados no corpo da mensagem, quando o usuário clicar 
no botão “Enviar!” ele não verá em sua barra de endereços aquele endereço 
enorme contendo uma cadeia de variáveis, Ele verá apenas o endereço do 
programa ativado: 


http://www. seusite,com,br/recebe dados. php 
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Outra grande vantagem do método POST é que não há limitação de tamanho 
dos dados que estão sendo enviados, ao contrário do método GET, que envia 
os dados por uma cadeia de variáveis de tamanho limitado. Portanto é reco- 
mendado utilizar o método POST para formulários que possuem muitas infor- 
mações a serem enviadas, O método GET pode ser usado em formulários mais 
simples, que possuem poucos campos. 


Por meio do método POST podemos enviar outros tipos de dados que não 
podem ser enviados pelo método GET, como, por exemplo, imagens ou ou- 
tros arquivos (para isso utilizamos o valor file na opção type da tag input do 
HTML. 


Como tratar as informações recebidas 


Depois de especificado qual o programa PHP que receberá os dados (na op- 
ção action da tag form), basta saber como trabalhar com esses dados dentro do 
programa PHP. Existem duas maneiras de acessá-los: 


1) Tratá-los como se fossem variáveis, colocando o símbolo $ seguido do pró- 
prio nome do campo definido no formulário, Exemplo: o campo nome do 
formulário poderia ser referenciado dentro do programa PHP pela variável 
$nome. O campo email seria referenciado pela variável $email, e assim por 
diante. Porém, esse método só funciona se à opção register. globals estiver 
habilitada no arquivo de configuração php.ini (por padrão, desde o PHP 
4.2.0 essa opção está desabilitada). 


2) Utilizar os arrays superglobais predefinidos pelo PHP. Existem dois arrays 
que o PHP utiliza: um para armazenar os valores enviados pelo método 
GETe outro para armazenar informações enviadas pelo método POST. Esses 
arrays são o $. GET e o $_POST. 


Nesse caso, o nome dos campos do formulário é usado como chave associati- 
va, € o valor dos campos é armazenado como os valores do array. Se usásse- 
mos, por exemplo, o método POST para enviar um formulário com os campos 
nome e email, dentro do programa PHP acessaríamos esses dados da Seguinte 
maneira: 

$ PostT{“nome"] 

$.POST["emait"] 


Se o método utilizado fosse o GET usaríamos: 


$.serl“nome'] 
$GET["emai]"] 


Por questões de segurança, os desenvolvedores do PHP recomendam o uso 
da segunda opção, ou seja, acessar os dados enviados a partir dos arrays 5. GET 
e $_POST. Porém, se você preferir utilizar a primeira opção, tome cuidado para 
não criar dentro do programa outras variáveis com o mesmo nome dos cam- 


pos do formulário, pois isso fará com que o conteúdo do campo seja sobres- 
crito, 


Funções especiais para formatação de dados 


Há algumas providências a serem tomadas quando um programa recebe um 
conjunto de dados. Imagine que você resolve desenvolver um fórum de dis- 
cussão, Um fórum é um local onde todos os usuários podem colocar mensa- 
gens para debater sobre determinado assunto. 


Então você desenvolve um programa que recebe as informações de um for- 
mulário e as grava em um banco de dados ou em simples arquivos em formato 
texto. Terminado esse programa, você coloca seu fórum para funcionar na 
Internet. No dia seguinte você diz: “Vou lá ver se os usuários estão colocando 
mensagens no meu fórum!”, Você entra em seu site, acessa o fórum e encontra 
uma foto pornô colocada em uma das mensagens. Isso ocorreu porque um 
usuário, 20 escrever sua mensagem, digitou um comando HTML que exibe 
uma imagem existente em outro site, Ele poderia, por exemplo, ter digitado: 


<img src="hrtp://wmw. siteporno.com.br/fotol. jpg"> 


Como nenhuma precaução foi tomada, os usuários poderiam utilizar qualquer 
comando HTML no meio de suas mensagens, e isso possivelmente faria com 
que conteúdos não desejados fossem acrescentados ao seu site. A solução para 
esse problema é utilizar uma função do PHP para transformar os comandos 
HTML, fazendo com que estes sejam exibidos na tela como texto comum, Essa 
função é a himlspecialchars, cuja sintaxe é a seguinte: 


htmispecialchars(<string>); 


Essa função retira as tags HTML e coloca caracteres especiais em seus lugares. 
As mudanças feitas são as seguintes: 


& é substituído por &amp; 
“é substituído por &quot, 
< é substituído por &lt, 


> é substituído por &gi 
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Ao aplicar a função himispecialchars sobre uma string e exibi-la na tela vere- 
mos apenas os comandos HTML digitados, e não os resultados gerados por 
esses comandos, pois a função transformou as tags em caracteres especiais 
que foram reconhecidos pelo browser. Acompanhe o exemplo a seguir: 


& exemplo8 1.php 


<?php 
ftexto = “<img src=http://wmy.siteporno.com.br/fotol.jpg>"; 
&novo. texto =htmispecialchars(Stexto); 
echo Stexto . "<br>"; 
echo  $novo texto; 


Po 


A variável $texto desse programa contém o valor original (digitado por um 
usuário, por exemplo) da string, e a variável $novo_texto contém o valor da 
variável $texto após a aplicação da função himispecialchars. A execução des- 
se programa mostra duas linhas na tela: a primeira linha mostrará a imagem 
fotol.jpg, que é “puxada” de outro servidor. A segunda linha mostra o valor da 
string em formato texto: 


<img sre=http://wew. siteporno. com.br/fotol. jpg> 


EEEO ETOT nm 


Isso ocorreu porque a função himispecialchars transformou os caracteres > e < 
em &gt; e &dt;. O browser leu esses códigos e apresentou na tela novamente os 
símbolos > e <, mas não os executou como se fossem parte do código HTML, 


Outra precaução a ser tomada no momento de receber os dados é a utilização 
de dados que contêm caracteres especiais, Sé, por exemplo; o usuário digitar 
no campo nome do formulário a seguinte informação: 


João da Silva, vulgo “João da Maloca” 
O valor recebido pelo programa PHP será: 
João da Silva, vulgo \“João da Maloca” 


O PHP coloca o caractere de controle Vantecedendo caracteres especiais para 
evitar um erro na leitura das variáveis. Existe uma função que, aplicada a uma 
string, retira seus caracteres de controle, Essa função é a stripslashes, cuja sin- 
taxe é a seguinte: 


stripslashes (<string>): 


A 


Ao aplicar essa função sobre uma string, V é substituído por ”, V é substituído 
por’, e assim por diante. Dois caracteres de controle seguidos (N) são substi- 
tuídos por apenas uma barra invertida O). 


Quando utilizamos o método GET, outras funções que podem ser utilizadas 
no tratamento dos dados recebidos são as funções urldecode e urlencode. 
Essas funções são úteis porque todos os caracteres que não são alfanuméricos 
(com exceção do ) são convertidos para um código hexadecimal antecedido 
pelo simbolo %. Por exemplo: passando o nome Joaquim de Souza” pelo mé- 
todo GET, teremos a seguinte URL: 


http://www. seusite.com.br/recebe dados. php?nome=JoaguimkZOdeX20Souza 


Então dentro do programa recebe dados php deveríamos ter a seguinte linha: 


fnome = urldecode ($nome); 


Aplicando a função uridecode sobre a variável $nome, os códigos hexadeci- 
mais serão substituídos pelos caracteres que eles representam. Já a função ur- 
lencode faz o processo contrário, transformando os caracteres não-alfanumé- 
ricos para seus respectivos códigos. Se a variável $nome possuísse o valor 
"Joaquim de Souza", após a aplicação da função urlencode teríamos o valor 
Joaquim%20de%20Souza. Essa função é útil quando queremos redirecionar 
esses dados para outro programa PHP por meio do método GET, 


Verificando os campos de um formulário 


Vamos ver um exemplo de verificação dos campos de um formulário. Supo- 
nha que temos um formulário com os seguintes campos: username, senha, 
nome, email, cidade e estado, conforme mostrado na figura 8.3: 


Cidade: | Estado: E 


Figura 8.3 — Formulário a ser validado. 


O código para esse formulário HTML é o seguinte: 


<form method="post” action="recebe. dados .php”> 
«div align="center"><center> 
«p>username: <input type="text” name="username” size="10">ênbsp;ênbsp; 
senha: <input type="password” names"senha” size="10"></p> 
</center></div> 
«div align="center”><center> 
«p>Nome: <input type="text” name="nome” size="20></p> 
</center></div> 
«div align="center/><center> 
<«p>E-mail; <input type="text” name="email” size="20"></p> 
«/center></div> 
<div align="center"><center> 
<p>Cidade: <input type="text” name="cidade” size="20">Enbsp;ênhsp; Estado: 
<input type="text” names"estado” size="2" maxdength="2"></p> 
«/center»</div> 
«div aligna"center"><center> 
<p><input types"submit” values"Enviar” names“enviar"></p> 
«fcenter>e/div> 


</form> 


Após o usuário preencher o formulário e clicar no botão “Enviar”, os dados 
serão submetidos ao programa recebe, dados.php, que fará a verificação. Va- 
mos ver então como poderia ser esse programa, Lembre-se que primeiramen- 
te temos que obter os dados enviados pelo usuário acessando o array predefi- 
nido $_POST, visto que o formulário está utilizando esse método de envio 
(method="POST. 


& recebe dados.php 


<html> 

<body> 

<?php 

$username = $ POST["username"]; 
fsenha = $.PosTI"senha"l; 

fnome = $. POsT["nome"]; 

$email = S.posti“email"J; 
$cidade = $_PosT{["cidade"]; 


j 


Sestado = $ PostT["estado"]; 


Serro=0; 
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if (strlen(Susername)<5) 

{ echo “o username deve possui no mínimo 5 caracteres, <br>”; $erro=1; } 
if (strlen($senha)<5) 

{ echo “a senha deve possui no mínimo 5 caracteres. <br>"; $erro=1; } 
if ($username == $fsenha) 

fecho “O username e a senha devem ser diferentes.<br>"; Serro=1; ) 
if CemprylSnome) OR strstr (Snome, * "Je=EALSE) 

(echo “Favor digitar seu nome corretamente, <br>"; Serro=l; } 

if (strlen(femail)<8 || strstr (Semail, '€')==FALSE) 

{ echo “Favor digitar seu e-mail corretamente. <br>": Serrosl; + 

if Cemptyl($Scidade)) 

{ echo “Favor digitar sua cidade.<br>"; Serro=l; } 

if (strlen(festado) |=2) 

{ echo “Favor digitar seu estado corretamente: <br>"; Serro=l; + 

// VERIFICA SE NÃO HOUVE ERRO 

if lSerro==0) 

{ echo “Todos os dados foram digitados corretamente!" } 

F> 

</body> 

</html> 


Esse programa testa cada um dos campos do formulário, e imprime mensa- 
gens de erro para cada campo que foi digitado incorretamente ou foi deixado 
em branco, Algumas das funções utilizadas devem ser desconhecidas para você, 
por isso veremos uma rápida explicação sobre cada uma: 


Função Descrição 

empty | Verifica se determinada string está vazia (nula). 000000 

strien Retorna o número de caracteres de uma string. 

strstr Acha a primeira ocorrência de uma string. Se não encontrar retorna falso 
(FALSE). 


No programa recebe _dados.php estamos fazendo os seguintes testes: verifi- 
cando se o username e a senha possuem no mínimo 5 caracteres; se o userna- 
me ea senha não são iguais; se o nome não está vazio e também se o nome 
possui o caractere espaço (se não houver, não foi digitado o nome completo); 
se o e-mail tem no mínimo 8 caracteres e possui o símbolo @; se o campo 
cidade não está em branco; se o campo Estado não possui dois caracteres, 


Ess programa não tem muita utilidade porque ele apenas faz a verificação dos 
dados recebidos, mas não dá nenhum destino a eles. Mais adiante você verá 
como gravar esses dados em um banco de dados para acessá-los posterior- 
mente. 


Capítulo 9 


Passando informações por várias 
páginas 


No capítulo sobre formulários vimos como um programa PHP recebe os da- 
dos enviados por um formulário ou por um link. No entanto existem diversas 
situações em que precisamos repassar esses dados para as próximas páginas 
que serão chamadas. Um exemplo que é comum nos dias de hoje é o do ca- 
dastramento de usuários em um site. Como geralmente os formulários de ca- 
dastro possuem muitos campos a serem preenchidos, Os desenvolvedores 
optam por dividir esse cadastramento em duas ou mais etapas (páginas). Des- 
«a forma deve haver uma comunicação entre as páginas, de modo que quando 
o usuário chegar na última etapa, saibamos todos os dados fornecidos por ele 
desde a primeira etapa. 


Outro exemplo que pode ser citado é o de um site de busca, que possuí 
uma página para cadastramento de novos sites, Geralmente esse cadastra- 
mento é dividido em etapas. Na primeira página você digita o nome do 
seu site, descrição, endereço, categoria etc. Depois você clica em um bo- 
tão para prosseguir o cadastramento. Na segunda página são pedidas ou- 
tras informações, como seu nome, e-mail, cidade, Estado etc. Na próxima 
etapa aparecem alguns campos de preenchimento opcional, como, por 
exemplo, áreas de interesse. Por fim é ativada uma última página, que re- 
cebe todos os dados enviados pelo usuário desde a primeira página e efe- 
tua o cadastramento dele no site. 


Veremos agora como pode ser feita essa troca de informações entre as pági- 
nas, pelos métodos GET e POST. Logo após veremos um exemplo em que é 
feita a divisão de um cadastramento em etapas. 
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Utilizando o campo hidden dos formulários 


Hidden traduzido para o português significa escondido. Portanto, você já pôde 
perceber que o tipo hidden serve para passar informações escondidas para a 
página que será acionada pelo formulário. Por ser um tipo de campo de um 
formulário, o hidden é geralmente utilizado quando estamos trabalhando com 
o método POST para o envio dos dados. 


Veremos agora um exemplo simples em que podemos utilizar esse recurso, 
Vamos supor que temos um formulário para administrar uma loja, onde é pos- 
sível incluir, alterar e excluir produtos. Os dados dos produtos são representa- 
dos pelos seguintes campos do formulário: codigo. produto, nome. produto e 
descricao, produto. Então poderíamos ter uma página HTML com três formu- 
lários, um para cada função, mas todos ativando o mesmo programa. Nesse 
caso, observe a utilização do campo hidden: 


<p>restrong>Inclusão de produtos</strong></p> 

<form method="POST”. action=s"gerencia.php'> 

<input type="hidden” name="operacao” values"inclusão"> 

<p> 

código do produto: <input type="text” name="codigo produto” size="5"sebr> 
Nome do produto: <input type="text” name="nome. produto” size="20"><br> 
Descrição do produto: <input type="text” name=" descricao produto” size="20"> 
</p> 

<p><input type="submit" vajue="Incluir” name=" incluir"></p> 


</form> 


<p><strong>Alteração de produtos</strong></p> 

<form method="POST" actions"gerencia.php"><p> 

<input type="hidden” names"operacao” values"alteracao”» 

código do produto: <input type="text” name=" codigo produto” sizes”5"><br> 
Novo Nome do produto: <input type="text” name="nome produto” sizes"20"><br> 


Nova Descrição do produto: <input type="text” names" descricao. produto” 
size="20"> 


</p> 
<p><input type="submit” value="alterar” name="alterar ></p> 


</form> 


<p><strong>Exclusão de produtos</strong></p> 
<form method="POST” action="gerencia,php"><p> 


<input type="hidden” name="operacao” value="exclusao”> 


código do produto: <input type="text” names"codigo. produto” siges"S">abr> 
<input type="submit” value="Excluir” name="excluir"></ps 


</form> 
As opções de um campo do tipo hidden são: 


Descrição 


Nome do campo, que posteriormente se tornará uma variável no programa 
PHP. 


value Valer do campo indicado por name. 


Note que os três formulários acima ativam o programa gerencia. php. Portanto, 
esse programa tem de ser capaz de realizar as funções de inclusão, alteração e 
exclusão de produtos. O programa saberá qual das três funções executar quan- 
do consultar o campo operacao, passado no modo escondido (hidden) pelo 
formulário. Logo, o programa poderia ser escrito da seguinte maneira: 


& gerencia.php 


<?php 
foperacao = $. posT[“operacao"]; 


if (Soperaçao == “inclusao”) 


{ 
¿/ realiza a inclusão do produto 
echo “Produto incluido!”:; 

} 

elseif (Soperacao == “alteracao") 

{ 
// realiza a alteração do produto 
echo “Produto alterado!”; 

} 

elseif (foperacao == “exclusao") 

t 
¿/ realiza a exclusão do produto 
echo “Produto excluido!” ; 

} 

> 


Esse programa executa diversas funções, e isso é possível graças ao parâmetro 
que passamos pelo campo hidden. Se não utilizássemos esse campo, teríamos 
de criar três programas: um para incluir, outro para alterar e outro para excluir 
produtos, 
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Passando informações pela URL 


Outra forma de fazer uma comunicação entre as páginas é a passagem de 
valores pela URL, que utilizamos somente no método GET de envio de 
dados, 


Imagine um site que possui um jogo de perguntas e respostas, em que os usu- 
ários se cadastram e logo após começam a responder as perguntas, A cada 
resposta correta O usuário soma 100 pontos. O dono do site resolve fazer à 
seguinte promoção para estimular os usuários: 


“Recomende um amigo para participar do jogo, e ganhe 500 pontos!” 


Para isso cada usuário, que possui um número identificador recebido no mo- 
mento do cadastro, deve enviar um link especial para seus amigos. O link deve 
possuir o endereço do site e logo após o número identificando o usuário que 
faz a recomendação. O usuário de identificação 405, por exemplo, deve enviar 
o seguinte link para seus amigos clicarem: 


herp://mem.perguntas-respostas. com/index. php? id=405 


Provavelmente antes de se cadastrar no jogo, a pessoa que foi recomendada 
vai querer ler o regulamento, ver quais são os prêmios que o site oferece etc. E 
para isso ela navega pelo site. Então vem a pergunta: se a pessoa está navegan- 
do pelo site, quando chegar no momento do cadastro, como o sistema vai 
saber quem foi que recomendou essa pessoa? Quem deve receber os 500 pon- 
tos pela recomendação? A solução é utilizar a passagem de informações pela 
URL. 


Dessa forma, todo link que for clicado dentro do site deve passar como 
parâmetro o identificador recebido, no caso o 405. O identificador poderá 
passar por várias páginas, até chegar na página de cadastramento. Quan- 
do a pessoa efetuar o cadastramento, o identificador do usuário pode ser 
enviado no formulário do cadastro pelo campo hidden, conforme vimos 
anteriormente, Um programa receberá os dados do formulário, cadastrará 
esse novo usuário e computará mais 500 pontos para o usuário de identi- 
ficador 405. 


Essa é uma maneira muito útil de trocar informações entre as páginas. Depen- 
dendo do tipo de aplicações que você precisa desenvolver, muitas vezes deve- 
se recorrer a essa alternativa, 
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Dividindo o cadastramento de usuários em etapas 


Como já foi dito no início deste tópico, muitas vezes os sites possuem 
formulários com muitos campos a serem preenchidos, e isso leva os de- 
senvolvedores a fazer uma divisão do cadastramento em mais de uma pá- 
gina. Agora vamos ver como podemos dividir um cadastramento e utilizar 
o campo hidden do formulário para passar informações entre as páginas. 
Os campos que temos são os seguintes: nome, email, datanascimento, sexo, 
profissao, endereco, telefone, cidade, estado, cep, username, senha e 
confirma senha, Dividiremos esses campos em três páginas. Na primeira 
página colocamos somente os dados pessoais: nome, email, datanasci- 
mento, sexo e profissao. Na segunda página colocamos os campos telefo- 
ne, endereco, cidade, estado e cep. Por fim, na terceira página colocamos 
os dados de identificação no site: username, senha e confirma senha. A 
divisão é mostrada nas figuras a seguir: 
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Cadastramento - Etapa 1 de 3 
Nome 771] 
E-mait [ Tie eE 


Data de nascimento: | 


Sexo: € Masculino € Feminino 


Profissão: | ; 


Figura 9.1 — Primeira etapa do cadastramento. 
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Cadastramento - Etapa 2 de 3 


Telefone: po 
Endereco: ES a A 
Cidade: a Estado no 
cep 


Figura 9.2 = Segunda etapa do cadastramento. 


Cadastramento - Etapa 3 de 3 
Usemame 7 
Senha 
Confirme sua Senha 


Figura 9.3 — Terceira etapa do cadastramento, 


Essas páginas foram nomeadas como etapa. php, etapa? php e etapa3. php. É 
importante lembrar que na etapa 2 devemos receber os dados digitados na 
etapa 1, ena etapa 3 devemos receber os dados digitados nas etapas 1 e 2, Veja 
o código de cada uma das páginas, e preste atenção na utilização do campo 
hidden para passagem de dados: 


& etapal.php 


(poderia ser html ao invés de php, pois aqui ainda não há código PHP) 


<html> 

<body> 

<p align="center'><big><big> 

<strong>Cadastramento - Etapa 1 de 3</strong></big></big></p> 

<form method="POST” action="etapa?.php”> 

<div align="center"><center><p> 

Nome: <input type="text” name="nome” size="20"></p></center></div> 

<div align="center"><center><p> 

E-mail: <input type="text" names"email” size="20"></p></center></div> 

<div align="center"><center><p> 

Data de nascimento: <input type="text” name="datanascimento” size="20"></p> 
</centera</div> 

<div align="center"><center><p> 

Sexo: <input type="radio" value="masculino” checked name="sexo"> 
Masculinoênbsp;ênbsp; 

<input type="radio" name="sexo” value="feminino">Feminino</p></center></div> 
<div align="center"><center>ep> 

Profissão: <input type="text” name="profissão” size="20"></p>e/center></div> 
<div align="center" ><center><p> 

<input type="submit” value="Prosseguir &gti&gt;" name=" prosseguir” ></p> 
</center></div> 

</form> 

</body> 

«fhimi> 


Na opção action da tag form indicamos a página etapa2.php para receber os 
dados digitados. A página etapa2,php, que também possui um formulário, deve 
utilizar na opção action a página etapa3.php. Como a página etapa2,php tam- 
bém possui campos a serem preenchidos, quando for ativada a etapa3.php, 
essa página deverá receber os dados fornecidos na primeira e na segunda eta- 
pa. 


Para isso utilizaremos campos do tipo hidden no formulário da segunda etapa. 
Desse modo estaremos incluindo os dados da primeira etapa com os da se- 
gunda. Veja como ficaria o código: 


122 Desenvolvendo Websites com PHP 


& etapa2.php 


<html> 
<body> 
<p align="center'><big><big><strong> 
Cadastramento - Etapa 2 de 3</strong></big></big></p> 
<form method="POST” action="etapa3.php”> 
<input type="hidden” name="nome” value="<?php echo Snome; ?>"> 
<input type="hidden” name="email” value="<?php echo $email; 2>"> 
<input type="hidden” name="datanascimento” values” 
<?php echo Sdatanascimento; 7>"> 
<input type="hidden” name="sexo” value="<?php echo $sexo; ?>"> 
<input type="hidden” names"profissao” values"<?php echo Sprofissão, ?>"> 
<div align="center" ><center><p> 
Telefone: <input type="text” names"telefone” size="20"></p></center»</div> 
<div align="center">ecenter><p> 
endereco: <input type="text” names"endereco” size="20"></p></center></div> 
«div align="center”><center><p> 
Cidade: <input type="text” names"cidade” size="20">&nbsp;ênbsp; ênbsp; 
Estado: <input type="text” name="estado” size="2"></p></center></div> 
<div align="center” ><center><p> 
CEP; <input type="texg” name="cep” size="9"</p></center></div> 
«div align="center"><center><p> 
<input type="submit” values"prosseguir &gt;&gt;” name="prosseguir"></p> 
«/centers</div> 
</form> 
</body> 
«</html> 


Observe que após a tag form estamos passando todos os campos obtidos na 
primeira etapa. Isso é feito por meio da opção value dos campos de entrada do 
tipo hidden. Logo após estão os campos do formulário que devem ser preen- 
chidos nesta etapa (telefone, cidade etc). Quando o usuário clicar no botão 
“Prosseguir”, todos os campos serão enviados para a página etapa3.php, em 
que será realizada a última etapa do cadastramento. A página etapa3.php po- 
derá ativar uma quarta página, que recebe os dados digitados nas três primei- 
ras e realiza o cadastramento do usuário no banco de dados do site. 


Vamos supor que existe a página cadastra. php, que recebe todos esses dados 
e efetua o cadastramento. Então, o código para a página etapa3.php seria O 
seguinte: 


p 
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inicie ii arenitos 


& etapa3.php 


<html> 

<body> 

<p align="center"> <big><big><strong> 

Cadastramento - Etapa 3 de 3</strong></big></big></p> 

<form method="POST" action="cadastra.php”> 

<input type="hidden" name="nome" value="<?php echo $nome:; 7>"> 
<input type="hidden" names"email” value="<?php echo $email: 7>"> 
<input type="hidden" name="datanascimento” values” 

<?php echo $datanascimento; 7>"> 

<input type="hidden” names" sexo” value="<?php echo fsexo; 7>"> 
<input type="hidden” names"profissao” value="<?php echo profissão: 7>"> 


<input type="hidden" names"telefone” value="<?php echo Stelefone: 7>"» 


<input type="hidden" name="endereco” value="<?php echo fendereco; ?»"> 
<input type="hidden” name="cidade” value="<?php echo Scidade; ?>"> 

<input type="hidden" name="estado” value="<?php echo festado; 7>"> 

<input type="hidden” names'cep” value="<?php echo $cep: ?>"> 

<div align="center">«center><p> 

Username: <input type="text" name=s"username” sizes"10"></pre/center></div> 
<div align="center"><center><p> 

Senha: <input type="text" name="senha” sizes"10"></p></center></div> 

<div align="center"><center><p> 

confirme sua Senha: <input type="text” name="confirma senha” size="10"></p> 
</center></div> 

<div align="center'><center><p> 

<input type="submit” values"Finalizar cadastro” name="Fim'></p></center></div> 
</form> 

</body> 

</html> 


Quando o usuário clicar no botão “Finalizar Cadastro”, será ativada a página 
cadastra.php, que receberá os dados digitados desde a primeira etapa, que 
foram sendo passados por meio dos campos do tipo hidden. Essa página será 
encarregada de cadastrar o usuário no banco de dados do site utilizando as 
informações recebidas. Veremos mais adiante como fazer inserções em um 
banco de dados. 
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É claro que esse é um exemplo mais simples, pois as páginas não fazem ne 
nhuma verificação se os valores digitados nos formulários são válidos ou se 
algum campo foi deixado em branco. A idéia deste tópico era apenas explicar 
a passagem de informações entre diversas páginas. Já vimos em um tópico 
anterior como fazer a validação dos campos de um formulário, Se você prefe- 
rir, essa verificação também pode ser feita por meio da linguagem Javascript, 
porém isso não é recomendado. Como o Javascript roda no próprio browser 
do usuário, alguém pode simplesmente retirar o código de validação e enviar 
o formulário preenchido incorretamente, Utilizando o PHP não temos esse 
problema, pois o PHP é server-based, ou seja, roda no servidor. Nenhum usu- 
ário poderá ver ou alterar códigos PHP de seu site, 


Capítulo 10 


PHP e variáveis de ambiente 


O próprio nome já diz. Embora possam ser utilizadas nos programas PHP, es- 
sas variáveis são do ambiente do servidor Web, e não da linguagem PHP. Com 
o uso de variáveis de ambiente, podemos descobrir diversas informações úteis, 
como, por exemplo, qual o tipo de browser que o visitante está “utilizando, 
qual o endereço IP do visitante, de onde foi feita a requisição da página, qualo 
tipo de conteúdo solicitado ete. Ainda neste tópico você encontra a lista das 
principais variáveis de ambiente e a descrição de cada uma. 


| Utilizando a função getenv 


Para obter o valor das variáveis de ambiente, utilizamos a função getenv do 
PHP. Sua sintaxe é a seguinte: 


getenv (“nome da variável"): 


Podemos atribuir o resultado retornado por essa função a uma variável qual- 
quer do PHP. Se quisermos, por exemplo, saber qual foi o método de envio de 
dados utilizado, podemos realizar a seguinte atribuição: 


fmetodo = getenv (“REQUEST_METHOD”); 


Se tivermos, por exemplo, um formulário que utiliza o método POST para O 
envio de dados, podemos proibir alguém de enviar informações pela URL com 
O seguinte teste: 


if Cfmetodo == “GET”) 
{ 


echo “Errol Ọ método GET não é aceito para enviar os dados desse formulário!” 


} 
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O teste também pode ser feito diretamente com o uso da função, sem que seja 
feita uma atribuição antes, Exemplo: 


if Cgetenv (“REQUEST METHOD )== “GET'O 
{ 


echo “Erro! O método GET não é aceito para enviar os dados desse formuláriol”; 


j 


O getenv é uma abreviação para “Get Environment”. Get em português signi- 
fica obter. Environment significa ambiente. Portanto é por meio da função ge- 


tenv que podemos acessar essas variáveis especiais denominadas variáveis de 
ambiente, 


Descobrindo o endereço IP do visitante 


Cada máquina conectada na Internet possuí um endereço IP que a identifica 
na rede. Muitas vezes precisamos descobrir o endereço IP de um visitante do 
site para realizar algumas tarefas, 


Como exemplo podemos citar um programa que gerencia uma enquete em 
um site. O programa exibe uma pergunta e diversas alternativas de resposta. O 
visitante escolhe uma das alternativas e clica no botão “Votar”. Ao clicar nesse 
botão, o programa computa o voto do usuário e exibe o resultado parcial da 
enquete. Mas...e se O usuário tentar votar novamente? Imagine a seguinte en- 
quete: “Qual é o melhor time de futebol do Brasil”, Então aparece um torce- 
dor fanático do Flamengo e tenta votar 1.000 vezes só para ver seu time na 
frente. 


Para evitar esse tipo de problema, quando o visitante realizar seu primeiro 
voto, devemos armazenar seu endereço IP em algum lugar (pode ser um ban- 
co de dados ou em um simples arquivo-texto). Na próxima vez que ele tentar 
votar, fazemos a verificação para ver seo IP desse usuário já está cadastrado no 
banco de dados. Se estiver, exibimos uma mensagem dizendo que não pode 
votar novamente, pois seu voto já foi registrado. 


Para obter o endereço IP de um usuário utilizamos a variável de ambiente 
REMOTE_ADDR, como é mostrado a seguir: 


$ip = getenv(“REMOTE ADOR”); 


Outro local em que o endereço IP é utilizado como forma de controle são em 
salas de bate-papo (chat), Se um usuário entra em uma sala de conversação, e 
começa a digitar palavrões e xingar todos os outros, o administrador do chat 
pode proibi-lo de acessar a sala, bloqueando seu endereço IP, 


Capítulo 1 O * PHP e variáveis de ambiente 127 


Também podemos citar alguns concursos existentes na Internet que elegem 
mensalmente os melhores sites do país, com um selo colocado em cada site 
participante. Os visitantes clicam nesse selo e dão o voto para seu site preferi- 
do, Para não permitir que sejam realizados vários votos consecutivos pela 
mesma pessoa, o sistema desenvolvido deve verificar o endereço IP de quem 
está votando, para ver se esta pessoa está autorizada a votar. 


Portanto é importante que você saiba utilizar o endereço IP do usuário como 
um mecanismo de controle para manter a confiabilidade das informações exis- 


tentes em seu site, além de identificar usuários que de alguma forma tentam 
desrespeitar determinados regulamentos. 


Lista das variáveis de ambiente 


Já vimos que a função getenv é responsável por retornar os valores das diver- 
sas variáveis de ambiente para um programa PHP, Veja na tabela a seguir a lista 
das principais variáveis de ambiente existentes: 


Variável 


SERVER SOFTWARE | 


SERVER NAME 
GATEWAY INTERFACE 
SERVER, PROTOCOL 
SERVER PORT 
REQUEST METHOD 
PATH INFO 


PATH TRANSLATED 
SCRIPT NAME 


QUERY STRING 
REMOTE HOST 
REMOTE_ADDR 
AUTH_TYPE 


REMOTE_USER 
REMOTE. IDENT 


CONTENT TYPE 
CONTENT LENGHT 
HTTP ACCEPT 
HTTP USER AGENT 


Descrição 


Servidor e softwares uii utilizados (ex: Apache, PHP, eto, a 
Nome do servidor (hostname) ou endereço IP. 

Versão da especificação CGI que o servidor fornece. 
Nome e versão do protocolo utilizado (ex: HTTP/.1). 
Número da porta para a qual a requisição foi feita. 

O método de envio de dados utilizado (ex: GET, POST). 


Informação extra de caminho dada pelo cliente para acesso de 
alguns scripts. 


Versão traduzida do PATH, INFO. Faz um mapeamento de 
virtual para físico. 


Caminho virtual para o script que está sendo executado. Usado 
por páginas que reterenciam elas mesmas. 


Armazena tudo o que vem após o 7 em uma URL chamada. 
Nome do host (hostname) de onde veio a requisição. 
Contém o endereço IP do visitante que solicitou a página. 


Método de autenticação (usado por servidores que suportam 
autenticação de usuários). 


Nome do usuário (se o servidor suporta autenticação), 


Se o servidor suporta identificação-padrão REC 931, esta 
variável conterá nome do utilizador remoto que faz a requisição, 


Tipo MIME dos dados enviados. (ex: “exthimP. 
Tamanho dos dados (em bytes) recebidos pelo servidor. 
Lista dos tipos MIME que o cliente pode aceitar. 
Nome e versão do browser utilizado pelo cliente. 


Alguns provedores de hospedagem oferecem servidores com suporte ao MyS- 
QL, e outros com suporte ao PostgreSQL. Se você mesmo realizar a instalação 
do sistema operacional (Linux, Windows etc.), dependendo da distribuição, 
será possível optar na hora da instalação pelo servidor de banco de dados que 
deve ser instalado. Faremos uma comparação entre esses dois servidores, para 
que você conheça um pouco mais de cada um deles, e possa optar pelo que 
mais se adapta às necessidades de seu site. 


Comparação entre MySQL e PostgreSQL 


São dois excelentes SGBDs (Sistemas de Gerência de Bancos de Dados) gra- 
tuitos que podem ser usados com o PHP. O MYSQL está disponível sob a GPL 
licença pública GNU), além de possuir uma licença convencional, para quem 
não quiser estar limitado aos termos da GPL. Já o PostgreSQL está disponível 
sob a flexível licença BSD. 


O MySQL é mais utilizado no desenvolvimento de aplicações onde a velocida- 
de é importante, enquanto que o PostgreSQL se destaca por ser mais robusto e 
Possuir muito mais recursos. Esses recursos tornam o PostgreSQL um pouco 
mais qualificado do que o MySQL. 


Nas últimas versões do MySQL, os desenvolvedores acrescentaram diversos 
recursos que já existiam no PostgreSQL, como transações (confirmação ou 
cancelamento de operações realizadas), triggers (gatilhos), stored procedures 
(procedimentos armazenados), views (visões), lock de linha (bloqueio em ni- 
vel de linha) e constraints (cláusulas de integridade). 
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No entanto, o PostgreSQL continua sendo mais eficiente em vários aspectos. 
Possui um sofisticado mecanismo de bloqueio (MVCC), suporta tamanhos ili- 
mitados de linhas, bancos de dados e tabelas (até 16TB), aceita vários tipos de 
subconsultas, possui mais tipos de dados e conta com um bom mecanismo de 
failsafe (segurança contra falhas, como por exemplo no desligamento repenti- 
no do sistema). 


Como já foi dito no início desse tópico, a vantagem do MySQL é a velocidade 
de acesso. Para bases de dados muito grandes, o MySQL faz um acesso mais 
rápido que o PostgreSQL. Portanto se seu site possuir um banco de dados 
muito grande, vale a pena analisar a possibilidade de usar o MySQL. Para base 
de dados menores, não há diferença na velocidade de acesso entre os dois 
SGBDs. 


Outra alternativa: SQLite 


Além do MySQL e PostgreSQL, a versão 5 do PHP nos disponibiliza uma alter- 
nativa mais simples, porém limitada, para o armazenamento de dados. Trata- 
se do suporte ao SQLite, uma ferramenta SQL embutida. Os programas que 
utilizarem a extensão SQLite do PHP poderão trabalhar com bancos de dados 
SQL, sem que haja a necessidade de ter um SGBD instalado. A biblioteca SQLI- 
te lê e grava dados diretamente em arquivos de bancos de dados no disco, 


O SQLite aceita a maioria das construções do padrão SQL92, Portanto, é uma 
boa alternativa para quem precisa de velocidade e não necessita de todos os 
recursos oferecidos pelos SGBDs mais “pesados”. Mais informações sobre essa 
ferramenta podem ser obtidas no site: 


htp://sqlite org 


Inclusive, nesse endereço você pode fazer o download do programa sqlite, 
que serve para administrar bancos de dados SQLite pela linha de comando. 
Neste capítulo, vamos nos concentrar na criação e manipulação de bancos de 
dados em MySQL e PostgreSQL. Porém, se você tiver interesse em utilizar O 
SQLite, no próximo capítulo será apresentado um exemplo completo de utili- 
zação dessa ferramenta no PHP, 


Como criar um banco de dados 


Veremos agora como fazer para criar um banco de dados no MySQL ou no 
PostgreSQL, para posteriormente começar a criação de tabelas e manipulação 
de dados dentro desse banco de dados. 


i 
| 
: 
E] 
i 
, 
| 
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PostgreSQL 


Para criar um banco de dados no PostgreSQL, devemos utilizar o comando do 
Linux createdbou o utilitário psqi (utilizando o comando CREATE DATABASE), 
Se você não tiver a permissão para a criação de um banco de dados, deve-se 
solicitar ao seu administrador para que ele crie seu banco de dados inicial. 


Para criar, por exemplo, um banco de dados com o nome bdteste, na linha de 
comando do Linux digitamos o seguinte comando: 


$ createdh bdteste 


Digitando essa linha estará criado o banco de dados bedteste, em que serão 
armazenadas as informações que você desejar. O PostgreSQL possui um ge- 
renciador de conexões chamado postmaster, que deve estar rodando para que 
o banco de dados aceite as conexões solicitadas. 


Para acessar o banco de dados criado e começar a inserir as informações utili- 
zamos o utilitário psgl, que é um gerenciador que acompanha o PostgreSQL. 
Devemos digitar psql seguido do nome do banco de dados que desejamos 
acessar: 


$ psgl bdteste 


Ao digitarmos esse comando será mostrada uma tela para o gerenciamento do 
banco de dados, em que poderemos criar novas tabelas, inserir informações 


nas tabelas, realizar consultas e efetuar qualquer outra operação suportada 
pelo PostgreSQL. 


Devemos recorrer ao psg! quando desejamos saber quais são os bancos de 
dados que já foram criados e quais as tabelas e índices existentes em cada um. 
Veja a seguir a tela mostrada quando acessamos o banco de dados bdteste 


utilizando o psgl: 
welcome to psgl 7.3.4, the PostgresQL interactive terminal. 
Type: copyright for distribution terms 
\h for help with SOL commands 


\? for help on internal slash commands 


| 

| \g or terminate with semicolon to execute query 
| tg to quit 

, bdteste=# 


Digitando \? você tem acesso a todas as opções oferecidas pelo gerenciador, 
tais como visualização do nome das tabelas existentes dù, visualização dos 
índices (Adi), listagem dos bancos de dados existentes (AM e diversas outras 


opções. Você ainda pode utilizar a opção \h para obter ajuda na sintaxe de 
comandos SQL. 
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Para criar um banco de dados no MySQL, utilizamos o utilitário mysql Assim 
como no PostgreSQL, se você não tiver a permissão para a criação de um ban- 
co de dados, deve-se solicitar ao seu administrador para que ele crie seu ban- 
co de dados inicial, 


Caso você tenha permissão para criação de novos bancos de dados, basta digi- 
tar: 
mysql 


> create database bdteste; 


> use bdteste; 


A utilização do comando use é uma das diferenças em relação ao PostgreSQL. 
No MySQL devemos primeiramente executar o utilitário gerenciador, para de- 
pois escolher o banco de dados que será utilizado, e isso é feito por meio do 
comando use, 


Se a criação do banco de dados foi feita por seu administrador, provavelmente: 
você terá um nome de usuário e uma senha para acesso à sua base de dados, 
Para acessá-la, você deverá digitar o seguinte comando: 


mysql -u username ~p 


Por exemplo, supondo que no Linux o mysql esteja localizado em /usr/bin e 
você queira se conectar com o usuário root, bastaria digitar: 


/usr/bin/mysgl -u root -p 


A opção -u indica que o parâmetro seguinte é o nome de usuário utilizado 
para o acesso, e a opção -p indica que será digitado um password (senha) para 
conexão. Após a digitação da senha, você já estará conectado ao banco de 
dados criado, podendo inserir e manipular livremente seus dados. 


Toda a manipulação de dados deve ser feita por meio de comandos SQL (Struc- 
tured Query Language). Veremos ao longo deste capítulo os principais co- 
mandos SQL que podemos utilizar, 


Tipos de dados aceitos pelo MySQL e PostgreSQL 


Existem vários tipos de dados comuns entre o PostgreSQL e o MySQL, porém 
há alguns que estão disponíveis em apenas um deles. Vamos ver separada- 
mente os tipos de dados aceitos em cada um desses SGBDs. 
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PostgreSQL 


Existe uma grande variedade de tipos aceitos pelo PostgreSQL. A tabela a se- 
guir descreve todos eles; 


bitin) 
varbit(n} 
bool 


box 


bytea 
char(n) 
cidr 


circle 

date 
loat4, real 
loat8 

inet 


int8, bigint 


int, intá 
interval(p) 
line 

iseg 


macaddr 
numerici(p, s)] 
path 


point 


polygon 


Descrição e 

Siring de bits (0 om tamanho fixo. 

String de bits com tamanho variável. 

É o único tipo lógico. Utiliza 1 byte e pode armazenar o valor verdadeiro 
(t) ou falso (f); 

Utiliza 32 bytes para armazenar um quadrado definido pelas coordenadas 
de seus vértices opostos (CSATORNA) 

Dados binários. 

Seglência de caracteres com tamanho fixo. 

Armazena endereços de redes IPv4 ou IPv6. O formato é x.x.x.x/y, onde 
X.X.X.x é o endereço da rede e y o número de bits na máscara de rede. 


Utiliza 24 bytes para armazenar um circulo definido pelo seu centro (x,y) 
e seu raio (r). A sintaxe é «(x,y) >. 

Utiliza 4 bytes para armazenar uma data. Pode variar de 13/11/4713 
a.C. até 31/12/32767 d.C, 

Ponto flutuante que utiliza 4 bytes para armazenamento (6 casas 
decimais de precisão). 

Ponto flutuante que utiliza 8 bytes para armazenamento (15 casas 
decimais de precisão). 

Armazena o endereço IP de um ponto da rede, no padrão CIDR. O 
formato é x.x.x.x/y. Se y tor emitido, será considerado 32. 

inteiro que utiliza 8 bytes para armazenamento (intervalo varia de 
-9223372036854775808 a 9223372036854775807). 


Inteiro que utiliza 4 bytes para armazenamento (intervalo varia de 
-2147489648. 2 +2147483647). 


Utiliza 12 bytes para armazenar um intervalo de tempo, podendo variar 
de -1 78000000 anos até +1 78000000 anos. 

Utiliza 32 bytes pára armazenar uma linha infinita, definida pelas 
coordenadas de seus dois pontos (oy) Aaya): 

Utiliza 32-bytes para armazenar uma linha finita, definida pelas 
coordenadas de seus pontos extremos (xy) (XY). 

Endereço físico de um host (MAC). 

Valor numérico exato, com precisão e escala definida pelo usuário. 
Define um caminho fechado, utilizando os pontos (ix, SARUA REA CINA) 
fomecidos. Para definir um caminho aberto, usa-se os colchetes 
Kyy] Utiliza 16+16n bytes. 

É um dado geométrico. Utiliza 16 bytes para armazenar um porto no 
espaço definido por suas coordenadas (x,y). 


Armazena um poligono definido por suas coordenadas 
(DX eco (X a). Utiliza 40+16n bytes. 


MySQL 


smallint, int2 


serial 
serial 
text 

time [(p)] 


timetz [(p)] 
timestamp [(p)] 
timestamptz [(p)) 
varchar(n) 


tipos aceitos pelo MySQL são os seguintes: 


tinyint {MY} 

bit, bool, boolean 
smallint [(M)] 
meciumint [(M)] 
int (M)] 

bigint {M} 


float (precisão) 
float MD) 


double [(M,D)] 


real (M,D)] 
decimal [(MLD]] 


date 


datetime 
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inteiro que utiliza 2 bytes para armazenamento (intervalo varia de 
-32768 a +32767). 


Campo de autoincremento, Utiliza 4 bytes para o armazenamento, 
Campo de autoincremento. Utiliza 8 bytes para o armazenamento. 
Sequência variável de caracteres, sem tamanho máximo. 


Utiliza 8 bytes para armazenar uma hora do dia. Pode variar de 
0:00:00.00 a 23:59:59.99. O parâmetro opcional p indica o número de 
digitos fracionários do campo segundos. 


Utiliza 12 bytes para armazenar uma hora do dia, incluindo o time zone. 
Utiliza 8 bytes para armazenar data e hora. 
Utiliza 8 bytes para armazenar data e hora, incluindo o time zone., 


Sequência de caracteres com tamanho variável. O n define o tamanho 
máximo do campo. 


Descrição 

Inteiro pequeno. Varia de -128 até + 127. 

Sinônimo de tinyint(t). 

Inteiro variando de -32768 até +32767. 

Inteiro variando de -8388608 até +B388607. 

inteiro normal, variando de -2147483648 até +2147489647. 


Inteiro grande, variando de -9223372036854775808 até 
+9223372036854775807. 


Ponto flutuante com precisão definida. 

Ponto flutuante de precisão simples. Pode armazenar os seguintes 
intervalos: -3.402823466E+38 até -1.175494351E-38, 0, è 
1,175494351E-38 até 3.402823466E+38. 

Ponto flutuante normal. Os valores permitidos são de 
1.7976991348623157E+308 até -2.2250738585072014E-308,0, 
e também de. 2.2250738585072014E-308 até 
1.7976931348623157E+308. 

É um sinônimo para double. 

Esse tipo pode ser usado como uma string. Cada número 
corresponde a um caractere. 

Armazena uma data no formato yyyy-mm-dd, Pode variar de 1000- 
01-01 até 9999-12-31, 


Armazena data e hora. O intervalo suportado é de 1000-01-05 
00:00:00 até 9999-12-31 23:59:59, 
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time 
year [(2/4)) 


char(M) 
varchar(M) 
tinytext 
tinyblob 

text 

blob 
mediumtext 
mediumblob 


longtext 
longblob 


enum ('valort',..) 


set (valort',...) 


Observações: 


após a data base). 
Armazena um tempo. Varia de -838:59:59 até 838:59;59. 


Armazena um ano com 2 ou 4 digitos. O padrão é 4 dígitos. Varia 
entre 1901 e 2155.no formato e 4 dígitos, e de 1970 a 2089 no 
formato de 2 digitos. 


String de tamanho fixo, 

String de tamanho variável, Possui no máximo 255 caracteres. 
Texto contendo até 255 caracteres. 

Objeto BLOB com tamanho máximo de 255 caracteres. 

Texto com até 65535 caracteres. 

Objeto BLOB com até 65535 caracteres. 

Texto com o tamanho máximo de 18777215 (2% - 1) caracteres. 


Objeto BLOB com o tamanho máximo de 16777215 (2% - 1) 
caracteres. 


Texto com o tamanho máximo de 4294967295 (2% - 1) caracteres. 


Objeto BLOB com o tamanho máximo de 4294967295 (2% - 1) 
caracteres. 


String que pode conter apenas um dos valores listados ou NULL. 
Podem ser definidos até 65535 valores. 


String que pode conter 0 ou mais valores, cada um deles pertencente 
à lista informada, No máximo 64 valores podem ser digitados, 


* M representa o tamanho máximo para exibição. 


* D representa o número de dígitos após o ponto decimal. 


* Os colchetes indicam as partes opcionais, 


seguinte sintaxe: 


3; 


Como criar tabelas em um banco de dados 


Após a criação do banco de dados, podemos acessá-lo (com o psgl para Pos- 
tgreSQL ou o mysql para MySQL) e começar a criar as tabelas que armazena- 
rão os dados. Isso é feito por meio do comando CREATE TABLE, que possui a 


CREATE TABLE <nome tabela» ( 


<nome..campo>» tipo.de dado [NULL | NOT NULL] 
[DEFAULT valor padrão), 1... 


Foram apresentadas apenas as opções mais utilizadas do comando CREATE 
TABLE. No manual do SGBD, você verá uma descrição completa do comando, 
incluindo chaves primárias e outras opções, Veja o significado de cada uma 
das partes desse comando: 


Parte Descrição 

nome tabela Representa o nome da tabela que será criada. Não pode haver 
nomes de tabelas repetidos, 

nome. campo Representa o nome pelo qual o campo será referenciado. 

tipo de dado Deve ser substituído por um dos tipos apresentados no tópico 
anterior. 

NULL | NOT NULL Define se o campo pode aceitar valores nulos ou não. 

DEFAULT Define um valor-padrão para inserções na tabela. Esse valor será 


utilizado se nenhum valor para este campo for informado. 


Vamos agora utilizar uma loja virtual para exemplificar a criação de tabelas, 
Precisaremos de uma tabela para armazenar as informações dos produtos, 
Suponha que as informações referentes aos produtos são: 


código 

Nome 
Descrição 
Preço 

Peso 
Categoria 
Subcategoria 


Inf, adicionais 


Precisaremos também criar uma tabela para armazenar as categorias existen- 


1 
A 
l 
l 
- 
A 
l 
d 
É 


tes na loja. Para essa tabela as informações necessárias são: 


código da Categoria 


Nome da Categoria 


Teremos também que armazenar as subcategorias da loja em uma tabela, e 
para isso precisaremos dos seguintes dados: 


Código da Subcategoria 
Nome da subcategoria 


código da Categoria a que pertence 


Com o comando CREATE TABLE vamos criar três tabelas, que serão nomeadas 
como produtos, categorias e subcategorias, Observe os comandos a seguir, 
que devem funcionar tanto no MySQL como no PostgreSQL. 
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CREATE TABLE produtos ( 
codigo. produto smallint NOT NULL, 
nome produto varchar(80) NOT NULL, 
descricao. produto text, 
preco float NOT NULL, 
peso float, 
cod. categoria smallint NOT NULL, 
cod subcategoria smallint NOT NULL, 
adicionais text 

3 

CREATE TABLE categorias ( 
codigo. categoria smallint NOT NULL, 
nome. categoria varchar(60) NOT NULL 

J; 

CREATE TABLE subcategorias ( 
codigo subcategoria smal lint NOT NULL, 
nome subcategoria varchar(60) NOT NULL, 
codigo. categoria smallint NOT NULL 

ZA 

Os campos seguidos da cláusula NOT NULL não aceitarão valores nulos no 
momento da inserção no banco de dados. Apôs a execução dos três coman- 


dos apresentados, estarão criadas as tabelas produtos, categorias e subcatego- 
rias, 


A qualquer momento podemos visualizar o nome das tabelas que já criadas, 
assim como suas estruturas, Isso é feito por meio do terminal gerenciador que 
estivermos utilizando (mysql ou psgh. 


Visualizando com o mysql 


Utilizando o gerenciador do MySQL (mysql), para mostrar o nome das tabelas 
criadas digitamos: 


show tables; 

E para visualizar a estrutura de determinada tabela, basta digitar: 
describe <nome tabela»; 

ou a sintaxe alternativa: 


desc <nome tabela; 
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Devemos substituir <nome tabela> nome da tabela da qual você deseja ver a 
estrutura, Por exemplo: 


describe produtos; 


Você verá uma tela com os nomes dos campos, o tipo, se aceitam valores NULL, 
os valores-padrão e outras características da tabela consultada, 


Visualizando com o psql 


Utilizando o gerenciador do PostgreSQL (psgl), para mostrar o nome das tabe- 
las já criadas digitamos \dt, 


Se utilizarmos somente a opção \d, o gerenciador mostrará o nome de todas 
as tabelas, índices e sequências existentes nesse banco de dados, Para consul- 


tar individualmente cada uma dessas estruturas, utilizamos as opções \dt, \di e 
tds, 


Para visualizar a estrutura de uma tabela digitamos: 


\d <nome tabelas 


BEREA AA A EEEE 


Para visualizar, por exemplo, a tabela dos produtos digitamos: 


\d produtos 


Digitando esse comando você verá uma tela contendo o nome dos campos, o 
tipo e o tamanho de cada um deles, conforme é mostrado a seguir: 


bdteste=# Sd produtos 
Table "publie produtos” 


Colusn Type | Modifiers 
TAAT atama ma mane e aoe pre cem oan a o ee re PES 


! 

+ 
codigo, produto | smallint I not null 
nome, produto | character varying(80) | not rull 
descricao produto | text j 
preco | double precision l not null 
peso | double precision | 
cod categoria | smallint l not null 
cod subcategoria | smallint l not null 
adicionais i text G 


Agora você já tem condições de criar seu banco de dados e as tabelas que 
farão parte dele; além de poder visualizar a estrutura atual dessas tabelas e do 
próprio banco, O próximo passo é aprender a manipular os dados, fazendo 
inserções, atualizações e exclusões nas tabelas. 


Inserindo informações em um banco de dados 


Cada linha de uma tabela de banco de dados é chamada de registro, Para in- 
cluir um ou mais registros em uma tabela, utilizamos o comando SQL INSERT, 
Veremos agora como funciona esse comando, para que posteriormente você 
possa utilizá-lo em seus programas PHP, 


Comando INSERT 


É o comando responsável por incluir dados em uma tabela. Existem duas vari- 
ações para o comando INSERT: 


INSERT INTO «nome. tabela» VALUES (valori, valor2, ..., valorm); 
INSERT INTO <nome tabela» 

(nome campol, nome. campo2, ..., nome. campox) 

VALUES (valori, valor2, ..., valorx); 


Na primeira variação, os valores digitados no lugar de valori, valor2, ..., valorn 
serão incluídos na mesma ordem em que foram definidos os campos no mo- 
mento da criação da tabela definida por <nome. tabela>, Portanto, se fôssemos 
incluir um registro na tabela produtos, o valori seria armazenado no campo 
codigo. produto, o valor2 seria armazenado no campo nome. produto, O va- 
lor3 seria armazenado no campo descricao, produto e assim por diante, até o 
valor8, que seria armazenado no campo adicionais. Os campos criados com a 
cláusula NOT NULL devem ser obrigatoriamente preenchidos, caso contrário 
ocorrerá um erro na execução do comando INSERT. É importante lembrar que 
os valores numéricos não devem ser delimitados por aspas. Já os dados do 
spo char, varchar, date e outros devem ser delimitados por aspas simples. 


Na segunda variação do comando INSERT, os valores valor1, valor2, a, valorx 
serão inseridos nos campos campol, campo2, ..., campox da tabela definida 
por <nome .tabela>. Os campos da tabela não listados receberão o valor NULL 
ou o valor-padrão (caso exista um). Se os campos não listados foram criados 
com a cláusula NOT NULL, ocorrerá um erro na execução do comando IN- 
SERT. 


Observe o exemplo a seguir, em que utilizamos o comando INSERT para fazer 
a inclusão de um produto na tabela produtos: 
INSERT INTO produtos VALUES ( 
T 
‘camiseta do Grêmio’, 


‘camiseta com listras verticais nas cores azul, preto e branco’; 
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89.95, 
1.5, 

5, 

2, 


“Disponível com as seguintes numerações: 3,5, 9€e10'3; 


Executando esse comando estaremos incluindo nosso primeiro produto da 
loja, e ele é válido para os dois SGBDs (MySQL e PostgreSQL). 


No PostgreSQL, após a execução desse comando será mostrada uma linha do 
tipo: 


INSERT 16990 1 


Isso significa que o registro foi incluído com sucesso, e que o 16990 é uma 
identificação única do registro dentro do banco de dados: No MySQL, a men- 
sagem exibida após a execução deve ser do tipo: 


Query OK, 1 row affected (0.05 sec) 


Note que na tabela produtos existem três campos (descricao produto, peso e 
adicionais) que não foram declarados com a cláusula NOT NULL. Nesse caso 
podemos utilizar a segunda variação do comando INSERT: 


INSERT INTO produtos 
(codigo. produto, nome produto, preco, cod categoria, cod subcategoria) 


VALUES (2, 'Camiseta do Flamengo’, 49,95, 5, 2 j; 


Dessa forma os valores ocuparão os campos conforme a ordem definida, e os 
campos não listados ficarão com o valor NULL, 


Veja agora alguns exemplos de inclusões de categorias e subcategorias que 
podemos fazer nas tabelas que criamos anteriormente: 
INSERT INTO categorias VALUES (1 , 'Eletrodomésticos'); 
INSERT INTO categorias VALUES (2., ‘Cama, Mesa é Banho’); 
INSERT INTO categorias VALUES (3 , 'Áudio e video); 
INSERT INTO categorias VALUES (4 , 'Informática'); 
INSERT INTO categorias VALUES (5 , “Artigos Esportivos’); 
INSERT INTO subcategorias VALUES (1, ‘Bolas de Futebol’, 5); 
INSERT INTO subcategorias VALUES (2 , 'Camisetas de Futebol’, 5); 
INSERT INTO subcategorias VALUES (3 , 'Tênis e chuteiras’, 5); 
INSERT INTO subcategorias VALUES (4 , 'Raquetes de Tênis’, 5); 
INSERT INTO subcategorias VALUES (1 , 'DyDs!, 3); 
INSERT INTO subcategorias VALUES (2 , 'cos!, 3); 


INSERT INTO subcategorias VALUES (3 , “aparelhos de Som", 3); 
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Observação: se tivéssemos um campo do tipo date, o formato de entrada de- 
penderia da configuração do SGBD. O formato mais usado é O aaaa-mm-dd, 
delimitado por aspas simples (por exemplo: '2004-11-249. 


Alterando um banco de dados 


Existem dois tipos de alterações que podemos fazer em um banco de dados: 
alterar à estrutura de uma tabela ou alterar valores dos registros de determina- 
da tabela. Vamos ver como podem ser feitos esses dois tipos de alteração, por 
meio dos comandos SQL UPDATE e ALTER TABLE. 


Comando UPDATE 


O comando UPDATE realiza alterações nos valores dos registros de determi- 
nada tabela, Pode alterar um ou mais registros simultaneamente. Se for neces- 
sário, podemos alterar uma tabela inteira, utilizando apenas um comando UP- 
DATE. Sua sintaxe é a seguinte: 


UPDATE <nome. tabe la> 
SET campol=valori [, campoz=valor?, ..., camponsvalorn] 


[WHERE <condições>]; 


Se a cláusula WHERE não for utilizada, a alteração será efetuada em todos os 
registros da tabela, Portanto, tome muito cuidado para não esquecer essa clá- 
usula quando ela é necessária, pois isso fará com que sejam alterados diversos 
dados que não deveriam sofrer modificações. 


Se quisermos, por exemplo, alterar o código de uma categoria, podemos utili- 
zar o seguinte comando: 


UPDATE categorias SET codigo. categoria=6 WHERE codigo. categorias5; 


Podemos também alterar o código de todos os produtos que pertenciam a 
essa categoria: 


UPDATE produtos SET cod. categorias6 WHERE cod. categorias5; 


Sempre após a execução do comando UPDATE, o gerenciador do banco de 
dados utilizado informará quantos registros foram afetados pelo comando. 
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Comando ALTER TABLE 


Por meio deste comando podemos incluir campos em uma tabela. É possível 
ainda alterar o nome de um campo ou de uma tabela. Podem ser usadas as 
seguintes sintaxes: 


ALTER TABLE <rome tabela» ADD <nome. campo» tipo de. dado; 

ALTER TABLE <nome tabela» RENAME <nome campo» TO  <novo nome>: 

ALTER TABLE <nome tabela» RENAME TO <novo. nome tabelas; 
Para adicionar, por exemplo, o campo fabricante à nossa tabela de produtos, 
devemos executar a seguinte linha: 


ALTER TABLE produtos ADD fabricante varchar(50): 


O campo fabricante será incluído como o último campo da tabela produtos. 


importante: 1 não é possivel excluir campos de uma tabela. Se precisarmos excluir um campo, 
devemos apagar a tabela e criá-la novamente. No próximo tópico veremos como fazer a exclusão 
de uma tabela. 


Excluindo informações de um banco de dados 


Existem dois tipos de exclusões que podemos fazer em um banco de dados: 
excluir uma tabela ou excluir registros de determinada tabela. Veremos como 
podem ser feitos esses dois tipos de exclusão, por meio dos comandos SQL 
DELETE e DROP TABLE. 


Comando DELETE 


Este comando exclui um ou mais registros de determinada tabela, Sua sintaxe 
é a seguinte: 


DELETE FROM <nome..tabela> [WHERE <condiçõess]!; 


Se a cláusula WHERE não for utilizada, todos os registros da tabela serão ex- 
cluídos. 


Vamos ver alguns exemplos de utilização do comando DELETE. Para excluir a 
categoria Artigos Esportivos da tabela de categorias, podemos digitar o co- 
mando a seguir: 


DELETE FROM categorias where nome. categoria='artigos Esportivos’; 


Para excluir todos os produtos da categoria Áudio e Vídeo (que possui O códi- 
go 3), podemos digitar o comando a seguir: 


DELETE FROM produtos where cod.categoria=3; 
Para excluir todos os produtos existentes na tabela, bastá digitar: 
DELETE FROM produtos; 


Sempre após a execução do comando DELETE, o gerenciador do banco de 
dados utilizado informará quantos registros foram afetados pelo comando, 


Comando DROP TABLE 


Serve para excluir uma tabela do banco de dados. Sua sintaxe é a seguinte: 


DROP TABLE <nome_tabelal> [ ,<nome.tabelad>, ... J; 


Quando excluímos uma tabela estamos excluindo também todo o seu conteú- 
do. Para excluir as tabelas produtos, categorias e subcategorias basta digitar: 


DROP TABLE produtos, categorias, subcategorias; 


Existe também o comando DROP DATABASE, que serve para excluir um ban- 
co de dados inteiro, Porém, para executar esse comando é necessário que © 
administrador do sistema lhe dê essa permissão, 


Observação: quando utilizamos o PostgreSQL, podemos também excluir um banco de dados por 
meio do comando de Linux destroydb. Basta digitar esse comando seguido do nome do banco de 
dados que deve ser excluído. 


Fazendo consultas em um banco de dados 


Já vimos como incluir, alterar e excluir informações em uma tabela do banco 
de dados. Agora veremos como fazer consultas sobre essas informações que 
estamos manipulando. O comando SELECT é responsável pelos diversos tipos 
de consultas que podem ser feitas. Por essa razão, o SELECT é o comando SQL 
utilizado com maior frequência na maioria das aplicações que envolvem ban- 
co de dados. 


Comando SELECT 


Executando o comando SELECT, podemos selecionar todas as linhas de uma 
ou mais tabelas, ou apenas uma parte delas. Sua sintaxe mais básica é a seguin- 
te: 
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SELECT <Jistacampos> FROM <lista tabelas» [WHERE <condições>]; 


Se <lista. campos» for substituída por um asterisco (9), serão retornados todos 
os campos existentes na(s) tabela(s) em uso, Se a cláusula WHEREfor omitida, 
serão mostrados todos os registros das tabelas determinadas em </ista tabelas, 


Para listar, por exemplo, todas as categorias existentes em nossa tabela catego- 
rias, basta digitar: 


SELECT * FROM categorias; 


Teremos como resultado: 


bdteste=# select * from categorias! 
codigo categoria none categoria 


l 
+ 
| Eletrodomésticos 
| Cama, Mesa e Banho 
| Áudio e Video 
| Informática 

| Artigos Esportivos 
(5 rows) 


Essa tela mostra o resultado obtido por meio da execução do comando SZ- 
LECT no gerenciador do PostgreSQL. No MySQL você também verá uma tela 
parecida com essa, Todos os comandos que vimos até agora funcionam nos 
dois SGBDs (MySQL e PostgreSQL), já que ambos utilizam a linguagem SQL 
para manipulação de dados, 


Nesse caso existiam apenas dois campos, e coma utilizamos o *, todos foram 
mostrados, Veja outro exemplo semelhante, em que selecionamos todos os 
produtos cadastrados na tabela produtos 

SELECT * FROM produtos; 
O resultado será: 


bdtestest select * from o 
codigo. daria j produto í descricao produto 1 preco 
E peso | cod. pe n T j cod. | eubeategaria H adicionais 


e A mi rr ean aema ee a rp ro co me 


rg ga cs jr o a id ap a a a as 


seta do Grémio | Camiseta cos listras verticais nas cores azul, preto A raa FET 
E] 2 1 Disponivel cos as seguintes rmerações: 3, 5, 9 e 

24 Fai soka do Flamengo | E 49,95 
5 2 


i 
{2 rows) 


Todos os campos da tabela produtos foram mostrados, e isso causou uma difi- 
culdade na visualização dos resultados, já que os registros não couberam em 

apenas uma linha da tela. Para ter uma melhor visualização, podemos escolher 
apenas Os campos que nos interessam para serem exibidos. Se quiséssemos, 
por exemplo, ver o código, o nome e o preço de todos os produtos, bastaria 
digitar o seguinte comando: 


SELECT codigo. produto, nome produto, preco FROM produtos; 
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O resultado será: 


butestest SELECT codigo produto, nome produto, preco FROM produtos 
codigo produto | nome. produto | preco 
dg e a o cm San er cs a e a sp a is nt o od ca mi 


1 | Camiseta do Grêmio | 89,95 
2 | Camiseta do Flamengo | 49,35 
ie rows? 


Agora vamos ver um exemplo do comando SELECT, utilizando a cláusula WHE- 
RE para determinar quais registros devem ser retornados. Se quisermos, por 
exemplo, obter o nome e a descrição dos produtos que custam mais de R$ 
50,00, executamos o seguinte comando: 


SELECT nome.produto FROM produtos WHERE preco>50; 
O único produto retornado é a camisa do Grêmio, que custa R$ 89.95; 


bdteste=f SELECT nome. produto FROM produtos WHERE preco>50: 
nome. produto 


Camiseta do Grêmio 
(1 row? 


Qutro exemplo: listar todas as subcategorias pertencentes a uma categoria da 
loja. Vamos utilizar a categoria Artigos Esportivos, que possui o código 5, e 
visualizar todas as suas subcategorias. O comando que deve ser utilizado é o 
seguinte: É 


SELECT nome. subcategoria FROM subcategorias WHERE codigo, categoria=5; 
Observe o resultado: 


bdteste=# SELECT nome subcategoria FROM subcategorias WHERE codigo. categoria=D; 
nome, subcategoria 


Eolas de Futebol 
Camisetas de Futebol 
Tênis e Chuteiras 
Raquetes de Tênis 

(4 rowe) 


O comando WHERE deve ser seguido por uma ou mais condições, Essas con- 
dições podem conter os operadores de comparação >, <, >s, <s, = e <>, Se hou- 
ver mais de uma condição a ser analisada, utilizamos os operadores lógicos 
AND e OR entre elas. Quando for necessário, podemos utilizar os parênteses 
para determinar a ordem de avaliação das expressões. 


Veja mais alguns exemplos de consultas que podem ser feitas com a utilização 
do comando SELECT: 


SELECT nome. subcategoria FROM subcategorias WHERE codigo. categorias=?; 


Esse comando retorna o nome de todas as subcategorias pertencentes à cate- 
goria Áudio e Vídeo, que possui o código 3. 


SELECT nome. produto, preco FROM produtos 
WHERE cod, categoria=1; 
Esse comando retorna o nome e o preço de todos os produtos pertencentes à 
categoria Eletrodomésticos, que possui o código 1. 
SELECT nome. produto, descricao, produto FROM produtos 
WHERE cod subcategorias? 
O comando apresentado retorna o nome e a descrição de todos os produtos 
que possuem o número 2 como código da subcategoria. 
SELECT nome. produto, descricao. produto, preco FROM produtos 
WHERE cod, categoria=5 AND cod .subcategoria=2: 
Esse comando retorna o nome, a descrição e o preço de todos os produtos 


pertencentes à categoria Artigos Esportivos e à subcategoria Camisetas de Fu- 
tebol. 


SELECT nome, produto FROM produtos 


WHERE cod. categoria=5 AND cod .subcategoria=? OR cod subcategorias3; 


O comando apresentado retorna o nome de todos os produtos que perten- 
cem à categoria Artigos Esportivos e à subcategoria Camisetas de Futebol, ou 
retorna o nome dos produtos que possuem o código da subcategoria iguala 3, 
independentemente da categoria. Isso ocorre porque não utilizamos os pa- 
rênteses para informar a ordem de avaliação das expressões. Veja o mesmo 
exemplo, mas com a utilização de parênteses: 


SELECT nome. produto FROM produtos 


WHERE cod.categoria=5 AND (cod subcategoria=2 OR cod subcategoria=3); 


Esse comando retornará o nome de todos os produtos que pertencem à cate- 
goria Artigos Esportivos, e ao mesmo tempo pertencem à categoria Camisetas 
de Futebol ou Tênis e Chuteiras, A primeira expressão avaliada será a que está 
entre os parênteses, Portanto, primeiro será verificado se o código da subcate- 
goria é 2 ou 3, e caso seja, será avaliada a segunda expressão, que recupera 
todos aqueles registros que possuem o código de categoria 5, ou seja, que são 
da categoria Artigos Esportivos. 


SELECT codigo produto, nome, produto FROM produtos 


WHERE cod categoria=?2 AND preco<100; 


| 


Esse comando retornará o código e o nome de todos os produtos que perten- 
cem à categoria Cama, Mesa e Banho, e custam menos o que R$ 100,00. 


SELECT nome. produto, preco FROM produtos 


WHERE cod categorias4 AND preco>=50 AND preco<=500; 


O comando apresentado retornará o nome de todos os produtos que perten- 
cem à categoria Informática, e custam a partir de R$ 50,00, e no máximo de R$ 
500,00. Comandos desse tipo são interessantes quando o usuário deseja, por 
exemplo, fazer uma pesquisa por faixa de preços. 


A linguagem SQL nos oferece um operador de grande utilidade, que é o LIKE. 
Utilizando esse operador podemos fazer consultas que seriam extremamente 
complicadas de serem realizadas utilizando apenas os operadores lógicos e os 
de comparação. Podemos descobrir, por exemplo, todos os produtos que co- 
meçam com a letra “E”, ou todos que terminam com a letra “A”, ou ainda todos 
que contenham a letra “O”: Com o uso desse operador podemos também bus- 
car por palavras dentro de um campo dos registros existentes em uma tabela, 


Imagine um site que tem um banco de dados de veículos usados, onde existe 
uma tabela chamada veículos, que armazena informações como nome do ve- 
iculo, preço, cor e um campo chamado de adicionais, contendo os acessórios 
que o veículo possui. Então uma pessoa acessa o site, querendo comprar um 
veículo com ar-condicionado. Para mostrar a ela todos os veículos com ar- 
condicionado, podemos utilizar o comando SELECT com o operador LIKE: 


SELECT * FROM veiculos WHERE adicionais LIKE ‘Xar condicionados”; 
O comando LIKE é utilizado com o símbolo %, que representa uma sequência 
de caracteres, ou com o símbolo _, que representa um caractere qualquer. Para 


selecionar, por exemplo, todos os modelos de Kadett existentes no banco de 
dados de veículos, digitamos o seguinte comando: 


SELECT nome. veiculo FROM veiculos WHERE nome, veiculo LIKE 'KADETTX'; 
Veja um exemplo utilizando as tabelas que criamos anteriormente: 


bolteste=t SELECT * FROM categorias WHERE nome categoria LIKE "Xo": 
codigo.categoria none categoria 


2 | Cama, Mesa e Banho 
3 | Áudio e Video 
(Z rows? 


O comando executado retorna todas as categorias cujo nome terminam com a 
letra “o”, que nesse caso são “Cama, Mesa e Banho” e “Áudio e Vídeo”. 
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Outras formas de uso do operador LIKE: 


Operador Descrição 

LIKE E% A letra E está na segunda posição. ȚŢ7—— 

LIKE %0 Termina com a letra O. 

LIKE ‘ARESO Começa com a letra A, termina com a letra O e possui a letra E no 
meio, 

NOT LIKE WO% Retorna aqueles que NÃO contêm o caractere O, Podemos utilizar, 


por exemplo, para verificar se existem e-mails digitados 
incorretamente em um banco de dados, já que o caractere O deve 
existir em todos os e-mails. 


isso é interessante que as informações sejam armazenadas no banco de dados sempre em 
letras maiúsculas ou sempre em letras minúsculas, para facilitar as pesquisas, Por exemplo: no 
momento do cadastro de um usuário no site, quando formos incluí-lo no banco de dados, podemos 
utilizar uma função para transformar seu nome para letras maiúsculas, para depois fazer a inclusão. 
Já vimos uma função que é capaz de transformar para maiúsculos todos os caracteres de uma 
string. 


Quando um usuário digita sua cidade, também seria interessante transformá-la 
em letras maiúsculas antes de incluir no banco de dados, Se isso não for feito, 
pessoas que moram em Porto Alegre poderão digitar o nome da cidade de 
diversas formas: 


Porto Alegre 
PORTO ALEGRE 
porto alegre 
Porto alegre 
porto Alegre 
POrto Alegre 
PORTO Alegre 


Se não fizermos a transformação para letras maiúsculas, temos vários tipos de 
escrita diferentes para uma mesma cidade, e isso causaria uma grande confu- 
são na hora de pesquisar os usuários que existem em determinada cidade, 
Para visualizar os usuários existentes em Porto Alegre, teríamos de digitar o 
seguinte comando; 

SELECT * FROM usuarios WHERE cidade='porto Alegre’ OR cidade='PORTO ALEGRE! OR 


cidade='porto alegre OR cidade='Porto alegre” OR cidade='porto alegre” OR 
cidade='porto Alegre’ or cidade='Porto alegre"; 


Se transformarmos a string em letras maiúsculas antes de incluí-la no banco de 
dados, bastaria fazer a seguinte consulta para visualizar os usuários de Porto 
Alegre: 


SELECT * FROM usuarios WHERE cidades'PORTO ALEGRE! 


Suponha que existe um banco de dados que armazena os dados dos usuários 
do site. Esse banco de dados possui uma tabela chamada usuários, com os 
campos nome, email, cidade e estado. Uma consulta que poderia ser feita é a 
visualização do nome de todas as cidades existentes no banco de dados. Veja 
o seguinte comando: 


SELECT cidade FROM usuarios; 


Esse comando retorna o nome de todas as cidades, porém haverá muitas repe- 
tições, pois se existirem 500 usuários que moram em São Paulo, será mostrado 
500 vezes o nome dessa cidade. Do mesmo modo será feito para as demais 
cidades, Para solucionar esse problema utilizamos a opção DISTINCT, da se- 
guinte forma: 


SELECT DISTINCT (cidade) FROM usuarios; 


Dessa forma seria retornado apenas uma vez o nome de cada cidade existente 
no banco de dados. Portanto, utilizamos a opção DIST; INCT sempre que que- 
remos excluir valores repetidos do resultado de uma consulta. 


Agora vamos ver como realizar outros tipos de consultas, como por exemplo, 
contar o número de registro existentes em uma tabela, somar os valores de 
determinado campo, obter o valor máximo de determinado campo em uma 
tabela, etc. 


Para contar quantos registros existem, por exemplo, em nossa tabela de pro- 
dutos, utilizamos a função COUNT. 


SELECT COUNT(*) FROM produtos: 


Para contar quantos produtos existem na categoria Eletrodomésticos (codigo 
1), executamos o seguinte comando: 


SELECT COUNT(*) FROM produtos WHERE cod. categoria=1; 


Para somar os valores de determinado campo de uma tabela, utilizamos a fun- 
ção SUM. Vamos somar os preços de todos os produtos de nossa loja, execu- 
tando o seguinte comando: 


bateste=t SELECT SUMépreco) FROM produtos; 
sum 


139,9 
{1 row? 
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O resultado retornado foi R$ 139,9, que é a soma dos preços dos dois produtos 
cadastrados na tabela, um custando R$ 89,95 e o outro custando R$ 49,95, 


Para descobrir quanto custa o produto mais caro da loja, podemos utilizar a 
função MAX, que retorna o registro que possui determinado campo de maior 
valor: 


bdteste=t SELECT MAX (preco) FROM produtos: 
max 


Se ao invés da função MAX fosse utilizada a função MIN, seria retornado o 
menor valor, ou seja, o preço do produto mais barato da loja, 


Outra função que pode ser usada com o comando SELECTé a AVG (do inglês 
average), que calcula a média dos valores de determinado campo: 


bdteste=t SELECT AYG (preco) FROM produtos; 
avg 


69,95 
(i row) 


Em nosso caso, temos apenas dois produtos cadastrados no banco de dados. 
Esse comando calculou a média aritmética dos preços desses dois produtos: 
(89.95+49.95)/2 = 69.95. 


As funções SUM e AVG devem ser aplicadas somente sobre dados do tipo 
numérico, caso contrário ocorrerá um erro na execução do comando.Vamos 
inserir mais alguns produtos e subcategorias em nossas tabelas para estudar 
outros tipos de consultas que podem ser feitas: 
INSERT INTO subcategorias VALUES (1 , ‘Notebooks’ , 4); 
INSERT INTO subcategorias VALUES (2 , ‘Monitores’ , 4); 
INSERT INTO subcategorias VALUES (1, “Refrigeradores! , 1); 
INSERT INTO produtos VALUES ( 
3; 
“Notebook Compaq Presårio’, 
“Computador portátil com processador Pentium III 500 MHZ’, 
3300, 
3.5, 
4, 
As 


“Com 32M8 de memória RAM e HD de 4,3GB' 3; 


INSERT INTG produtos VALUES ( 
4, 
'Monitor Samsung Syncmaster’, 
'Monitor colorido de 14 polegadas", 
450, 


“Controle osp digital por microprocessador, independente de RGB’); 
INSERT INTO produtos VALUES ( 
5, 
“Refrigerador Brastemp”, 
‘Refrigerador side by side, com prateleiras em vidro temperado”, 
7500, 
150, 
À, 
1; 
'Porta em aço revestido com esmalte branco, que não deixa marcas de 
dedos’); 
A linguagem SQL nos oferece a opção GROUP BY, que nos permite agrupar os 
resultados de uma consulta. Se quisermos, por exemplo, saber quantos pro- 
dutos existem em cada uma das categorias, em vez de digitar um comando 


com COUNT para cáda uma , basta utilizar a opção GROUP BY, e mostrar 
todas de uma só vez. Veja o exemplo: 
bdteste=# SELECT cod categoria, COUNT Oe) FROM produtos GROUP BY cod categorias 


cod categoria | count 
E dat Goa karsana 


it 1 
4 i 2 
51 2 


(3 rous) 


O resultado da execução desse comando nos diz que existe 1 produto na cate- 
goria de código 1 (Eletrodomésticos), 2 produtos na categoria 4 (Informática) 
e 2 produtos na categoria 5 (Artigos Esportivos). O GROUP BY também pode 
ser utilizado com a opção HAVING, que seleciona alguns registros retornados 
pelo GROUP BY. Para retornar, por exemplo, somente as categorias que pos- 
suem 1 único produto cadastrado, digitamos o seguinte comando: 


SELECT cod categoria, COUNT(*) FROM produtos 


GROUP BY cod categoria HAVING COUNT (*®J=l; 


Vamos ver agora como realizar consultas utilizando mais de uma tabela, e fa- 
zendo o relacionamento entre elas. Quando utilizamos mais de uma tabela em 
uma consulta, e essas tabelas possuem campos com o mesmo nome, devemos 
colocar antes dos nomes dos campos o nome da tabela a que eles pertencem, 
elogo após um ponto (.). Para referenciar, por exemplo, o campo cod categoria 
da tabela produtos, devemos utilizar produtos.cod categoria como referência, 


Faremos uma consulta idêntica ao exemplo anterior, em que utilizamos o 
GROUP BY para mostrar o número de ocorrências de produtos em cada códi- 
go de categoria. Seria interessante se, ao invés do código da categoria, exibis- 
semos o nome da categoria, Como o nome das categorias está em uma tabela 
separada, o comando SELECT deverá utilizar as tabelas produtos e categorias, 
Veja como ficaria o comando: 


SELECT nome. „categoria, COUNT(*) FROM produtos, categorias 


WHERE codigo. categoriascod categoria GROUP BY nome categoria; 


Veja o resultado gerado pela execução desse comando: 


nome categoria | count 
Dan e e ne asia GDE caes 
Artigos Esportivos | 2 
Eletrodomésticos Í i 
Informatica | 2 
(3 rous? 


O teste realizado na cláusula WHERE (codigo categoriascod categoria) rela- 
ciona as tabelas produtose categorias através do código da categoria, e a op- 
ção GROUP BY faz o agrupamento dos nomes das categorias, mostrando o 
número de ocorrências de produtos dentro de cada uma delas. 
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Outro exemplo: selecionar o nome dos produtos e das subcategorias a que 
cada um pertence. Para isso temos de consultar as tabelas produtos e subcate- 
gorias. Essa é uma consulta um pouco confusa de montar, pois envolve três 
tabelas: produtos, categorias e subcategorias. Veja a seguir qual o comando 
que realiza essa consulta, para depois analisar uma explicação mais detalhada 
de cada parte da construção dessa consulta: 


SELECT nome. produto, nome subcategoria FROM produtos, subcategorias, categorias 
WHERE cod .subcategoriascodigo. subcategoria AND 
cod. categoriascategorias.codigo..categoria AND 


subcategorias. codigo. categoria=categorias, codigo. categoria; 


Executando esse comando teremos como resultado uma tabela contendo o 
nome dos produtos, ao lado do nome da subcategoria no qual estão inseridos. 
Veja na tela a seguir o resultado obtido: 


nome produto | none, subcategoria 
RN a A RN A r E na P E E 
Camiseta do Flamengo | Camisetas de Futebol 
Camiseta do Grêmio | Camisetas de Futebol 
Notebook Compag Presário | Notebooks 
Monitor Sansung Syncmaster | Monitores 
Refrigerador Brastemp | Refrigeradores 
(5 rows? 


Agora vamos analisar cada uma das partes do comando apresentado. Após a 
cláusula FROM aparecem os nomes das três tabelas que serão acessadas. Após 
a cláusula WHERE, começa a nossa lista de condições. A primeira condição 
(cod subcategorias codigo subcategoria) relaciona as tabelas produtose sub- 
categorias por meio do código da subcategoria. A segunda condição 
(cod categorias categorias.codigo. categoria) relaciona as tabelas produtos e 
categorias por meio do código da categoria. Note que antes do campo 
codigo categoria colocamos o nome da tabela a que pertence esse campo, 
seguido por um ponto. Isso foi feito porque na tabela subcategorias existe um 
campo com o mesmo nome. Por fim, a terceira condição 
(subcategorias.codigo categoria = categorias.codigo. categoria) relaciona as 
tabelas categorias e subcategorias, por meio do códido da categoria. Esse teste 
deve ser feito porque existem diversas subcategorias com o mesmo número, € 


sendo satisfeita essa condição estaremos selecionando apenas a subcategoria 
que nos interessa. 


- Ordenando os resultados de uma consulta 


Para ordenar os registros retornados por uma consulta a um banco de dados, 
utilizamos a opção ORDER BY. Após a opção ORDER BY podemos indicar 
diversos campos da tabela para serem ordenados. Os campos serão avaliados 
da esquerda para a direita, ou seja, O primeiro critério para a ordenação será o 
primeiro campo colocado, o segundo critério será o segundo campo, e assim 
por diante. 


Um exemplo seria mostrar em ordem alfabética o nome de todas os produtos 
da loja: 


bdteste=t SELECT codigo produto.none produto FROM produtos ORDER BY nose, produto: 
codigo. produto nome. produto 


l 
A ne Ean PE E E E A 
2 | Caniseta do Flanengo 
1 1 Camiseta do Grênio 
4 | Monitor Sansung Syncmaster 
3 | Notebook Compaq Presario 
5.1 Refrigerador Brastenp 


(5 rows) 
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Podemos também fazer uma ordenação decrescente dos resultados, e para 
isso basta utilizar a opção DESC após o nome do campo, conforme mostrado a 
seguir: 


bdtestes# SELECT codigo produto, nome produto FROM produtos ORDER BY nome produto DESC: 
codigo produto | nome produto 
edi doa e onda midi e nto 
5 | Refrigerador Brastemp 
3 | Notebook Compaq Pregário 
4 | Monitor Sansung Syncmaster 
1 | Camiseta do Gremio 
2 | Cmiseta do Flamengo 
(5 rous) 


Veja agora o exemplo seguinte, em que foi colocado mais de um campo após 
o ORDER BY. 


bdteste=z# SELECT codigo categoria, nome, subcategoria FROM subcategorias 
bdteste-t ORDER BY Codigo categoria, nome subcategorias 
codigo. categoria none subcategoria 


Refrigeradores 
Aparelhos de Som 

CDs 

DVDs 

Monitores 

Notebooks 

Bolas. de Futebol 
Canisetas de Futebol 
Raquetes de Tênis 

| Tênis e Chuteiras 


EMANA A Do Gol GS tn pa 


(IO rows?) 


Esse comando utiliza dois critérios para fazer a ordenação. O primeiro é O 
código da categoria, e o segundo é o nome da subcategoria. Assim, subcate- 
gorias que pertencem à mesma categoria dependerão do seu nome para de- 
terminar a ordem que elas serão retornadas no resultado da consulta. Note 
que os quatro últimos registros retornados nessa consulta possuem o código 
de categoria número 5, e estão ordenados alfabeticamente pelo nome, 


Determinando o número de linhas retornadas 


Utilizando a opção LIMIT, podemos determinar o número máximo de regis- 
tros que uma consulta pode retornar. Se, por exemplo, um usuário fizer uma 
busca pela palavra “CD”, e houver mais de 500 CDs na loja, obviamente não 
mostraremos os 500 CDs na mesma tela, pois isso demoraria um bom tempo e 
a página ficaria muito grande, 


Poderíamos, então, determinar que devem ser retornados no máximo 10 CDs, 
utilizando o seguinte comando: 


SELECT * FROM produtos WHERE nome. produto LIKE ‘CO X? LIMIT 10; 


Dessa forma exibiriamos apenas os 10 primeiros CDs ao usuário, e colocaría- 
mos um link para a próxima página, em que seriam mostrados os próximos 10. 
Porém, para pegarmos de 10 em 10, devemos utilizar a opção ORDER BY para 
ordenar os registros utilizando algum campo, pois se isso não for feito, a cada 
consulta os registros aparecerão em uma ordem diferente. Portanto, para re- 
tornar em ordem alfabética os 10 primeiros registros dessa consulta utilizamos 
o comando: 


SELECT * FROM produtos WHERE nome produto LIKE CD %º 
ORDER BY nome. produto LIMIT 10; 
O parâmetro OFFSET é utilizado em conjunto com o LIMIT, para determinar a 


partir de qual registro a consulta deve retornar. Portanto, para retornar os pró- 
ximos 10 registros, utilizamos o seguinte comando: 


SELECT * FROM produtos WHERE nome produto LIKE ‘CO %' 
ORDER BY nome. produto LIMIT 10 OFFSET 10; 


Então bastaria incrementar o parâmetro OFFSET de 10 em 10 para obter todos 
os produtos que contêm a palavra “CD”, 


Gravando os resultados em uma nova tabela 


Essa é uma função que está disponível somente no PostgreSQL. O MySQL não 
oferece esse suporte. Podemos gravar os resultados de uma consulta em uma 


nova tabela, e isso pode ser feito utilizando o comando SELECT com a opção 
INTO. 


Vamos criar, por exemplo, uma tabela de preços chamada tabela precos, con- 
tendo o nome e o preço de todos os produtos da loja. Para isso basta utilizar o 
seguinte comando: 


SELECT nome. produto, preco INTO tabela precos FROM produtos; 


Para ter certeza, que a tabela foi criada, peça ao psql para verificar sua estrutu- 
ra: 


botestezt ^d tabela precos 
Table “public,tabela precos” 


Column | Type | Modifiers 
PA A a K ANE I TA RE ONEA AE o N E 
none produto | character varying (80) | 
preco | double precision l 


Fazendo uma consulta à tabela você verá que todos os nomes e preços foram 
transferidos para essa nova tabela: 


“Utilizando INSERT e SELECT para inserir registros 


Essa é uma funcionalidade que pode ser explorada tanto no MySQL como no 
PostgreSQL. No tópico anterior criamos uma tabela chamada tabela precos, 
que armazena o nome e o preço de todos os produtos da loja. 


Agora imagine que foram adicionados mais 50 produtos tabela produtos da 
loja, e esse produtos possuem códigos que variam de 6 a 55. Como fazer para 
incluir esses 50 produtos em nossa tabela chamada tabela precos 


Para isso, faremos uma combinação dos comandos INSERT e SELECT, confor- 
me é mostrado a seguir: 
INSERT INTO tabela precos SELECT nome. produto, preco FROM produtos 
WHERE codigo. produto>=6 AND codigo. produto<=55; 


Dessa forma estamos selecionando o nome e o preço de todos os produtos 
que possuem o código na faixa de 6a 55 e incluindo-os na tabela tabela precos. 
Logo após, você pode executar um SELECT * FROM tabela precos, e verificar 
que todos esses produtos foram incluídos, 


Criando e utilizando sequências 


Sequência é um recurso que utilizamos para fazer uma numeração automática 
de determinado campo de uma tabela. Se você estiver usando o PostgreSQL, a 
maneira mais fácil de criar uma sequência é criando um campo do tipo SERIAL 
em uma tabela, Por exemplo: 
CREATE TABLE produto ( 
codigo SERIAL, 
nome varchar(70) NOT NULL 
); 


Se você estiver usando o MySQL, pode criar um campo com a propriedade de 
auto-incremento, da seguinte forma, 
CREATE TABLE produto ( 
codigo int NOT NULL AUTO. INCREMENT, 
nome varchar(70) NOT NULL, 
primary keyCcodigo) 
); 


Veja que, no MySQL, o campo com numeração automática deve ser declarado 
como chave primária (primary key) da tabela, para evitar a gravação de códi- 
gos repetidos, 

Em seguida, para inserir registros em qualquer uma dessas tabelas, faríamos 
do seguinte modo; 


INSERT INTO produto (nome) VALUES (' Raquete de Tênis’); 


INSERT INTO produto (nome) VALUES (“Taco de Baseball’); 


Note que incluímos apenas o valor para o campo nome, pois O campo codigo 
possui numeração automática. Portanto, o produto Raquete de Tênis ficará 
com o código 1, e o produto Taco de Baseball ficará com o código 2. 


No PostreSQL existe outra forma de criar sequências, utilizando o comando 
CREATE SEQUENCE. Vamos criar uma seqüência chamada seg teste. 

CREATE SEQUENCE seg. teste; 
Após a criação da sequência, podemos utilizar as funções NEXTVAL, CURR- 


VALe SETVAL para administrá-la. A função NEXT'VAL retorna o próximo valor 
da sequência, e incrementa o contador, Exemplo: 


SELECT NEXTVAL( seg teste”); 
A função CURRVAL retorna o valor atual da sequência. Exemplo: 
SELECT CURRVAL( seg teste'); 
A função SETVAL altera o valor do contador da sequência, Exemplo: 


SELECT SETVAL( seq teste", 5); 


Capítulo 12 


'PHP com banco de dados 


Chegou a hora de aprender como utilizar em seus programas PHP todos os 
conhecimentos adquiridos no tópico anterior sobre banco de dados e coman- 
dos SQL. Agora finalmente você aprenderá a dar um destino para as informa- 


ções que são recebidas por meio de formulários HTML, que vimos anterior- 
mente. 


Conectando com um banco de dados 


Antes de acessar um banco de dados e começar a realizar operações, precisa- 
mos abrir uma conexão com ele. Para isso, utilizaremos uma função de cone- 
xão e uma variável do PHP como ponteiro, para referenciar essa conexão. 


O PHP possui funções que trabalham com o PostgreSQL, e outras que traba- 
ham com o MySQL, Vamos ver corno fazer a conexão com o banco de dados, 
mostrando exemplo dos dois SGBDs. 


Em um programa PHP, para fazer a conexão com um banco de dados MySQL 
utilizamos a função mysql connect Sua sintaxe é a seguinte: 


mysgl..connect ([string servidor [, string usuário L, string senha [, 
bool nove. link L. int Flags.ciienteniiD 


Para fazer, por exemplo, a conexão com o banco de dados Ldteste, que possui 


como nome de usuário teste. e como senha teste 2, executamos a seguinte atri- 
buição: 


fconexao = mysql connect CClocalhost”, “teste”, “testez); 
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Se banco de dados estiver localizado em um servidor diferente, basta substi- : 


tuir localhost pelo nome ou endereço IP desse servidor. 


Logo após especificamos. através do comando mysql select. db qual serão | 


banco de dados utilizado: 


mysql. select.db (bdteste”); 


Feito isso, estará aberta a conexão, e poderemos manipular os dados, através . 


de inclusões, exclusões e alterações. Quando não formos mais utilizar uma . 
conexão aberta dentro de um programa, podemos fechá-la com o comando , 


mysql close. Exemplo: 


mysql. close ($conexao); 


Para não ter de repetir todos esses comandos em diversas páginas do site, seria | 


interessante a criação de uma include que faz a conexão com o banco de da- 
dós, Vamos criar essa include: 


& conecta mysql.inc 


<?php 
$conexaão = mysgl.connectr (“localhost”, “teste”, “testel!): 


mysql. select. db (bdteste'); 
?> 


Agora basta colocar uma chamada para essa include em todas as páginas que 
precisam acessar o banco de dados: 


include “conecta mysql. inc”; 


Quando for necessário fazer alguma alteração no servidor, username, senha 
ou no nome do banco de dados, precisaremos alterar um único arquivo em 
vez de ter de alterar cada uma das páginas, Lembre-se de que no final de cada 
página devemos fechar a conexão que foi aberta dentro da include, por meio 
do comando mysql closSconexao). 


Se a sua versão do MySQL for 4.1 ou superior, para aproveitar todos os seus 
recursos você deverá usar os comandos da biblioteca “mysql” Umproved Mys- 
QL), disponível na versão 5 do PHP. Por exemplo: 


*- ao invés de mysql connect, use a função mysqli connect, 
* a0 invés de mysql select. db, use a função mysqli select db; 


Os programas apresentados neste livro estão disponíveis para download no 
site da Novatec Editora nas duas versões (mysgle mysqld. 


PostgreSQL 


Em um programa PHP, para fazer a conexão com um banco de dados Pos- 
tgreSQL utilizamos a função pg connect. Sua sintaxe é a seguinte: 


pg. connect (string string conexão) 


Essa função abre uma conexão considerando a string fornecida como parâme- 
tro. Essa string pode possuir os parâmetros host, port tty, options, dbname, 
usere password. Para fazer, por exemplo, a conexão com o banco de dados 
bdteste, que possui como nome de usuário postgres, e como senha postgres, 
executamos a seguinte atribuição: 
fconexao = pg connect (“dbname=-bdteste port=5432 user=postgres 
passmord=postgres'): 

A porta-padrão para conexão com o PostgreSQL é a 5432, mas se for necessã- 
rio esse número pode ser alterado no momento da instalação. A função 
pg. conneciretorna um valor que é armazenado na variável conexao. Se houve 
algum problema na conexão, será retornado o valor Fa/se. Portanto, por meio 
da variável $conexao podemos testar se a conexão foi feita com sucesso, Po- 


demos fazer esse teste na mesma linha em que utilizamos o pg. connect Ob- 
serve: 


if(! ($con= pg. connect (“dbnamesbdteste port=5437 user=postgres 
passmord=postgres"))) 


{ 


echo “não foi possível estabelecer uma conexão com o banco de dados." 


} 


Quando não formos mais utilizar uma conexão aberta dentro de um progra- 
ma, podemos fechá-la com o comando pg close. Exemplo: 


pa.close (fconexao); 


Seria interessante a criação de uma include que faz a conexão com o banco de 
dados. Vamos criar essa include: 


& conecta. pq.inc 


<?php 
$str conexao = “dbnamesbdteste port=5432 user=postgres password=postgres”; 


if C CSconexao=pg connect (Sstr. conexao))) 


í 


echo “não foi possivel estabeleçer uma conexão com o banco de dados.”; 
exit: 
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Agora basta colocar uma chamada para essa include em todas as páginas que 
precisam acessar o banco de dados: 


include “conecta pg. inc”; 
Quando for necessário fazer alguma alteração no servidor, username, senha 


ou no nome do banco de dados, precisaremos alterar um único arquivo em 
vez de ter de alterar cada uma das páginas, 


Observação: lembre-se de que no final de cada página devemos fechar a conexão que foi aberta 


A principal diferença do PostgreSQL para o MySQL é que no MySQL precisa- 
mos primeiro fazer a conexão com o gerenciador, para depois escolher o ban- 


co de dados que será utilizado. No PostgreSQL, no momento da conexão já 
indicamos o nome do banco de dados que vamos acessar. 
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Executando comandos SQL em um programa PHP 


Depois que efetuamos a conexão com o banco de dados, podemos utilizar 
todos os comandos SQL que vimos anteriormente para fazer inclusões, altera- 
ções, exclusões e consultas. A partir de agora, a diferença entre o MySQL e o 
PostgreSQL são apenas os nomes dos comandos de cada um, pois a funciona- 
lidade deles é a mesma. Para executar comandos SQL no MySQL utilizamos a 
função mysql query, e no PostgreSQL utilizamos a função pg query. 


MySQL 


Vimos que devemos selecionar por meio do comando mysgl select db um 
banco de dados para ser utilizado. Em seguida, para executar comandos em 
um banco de dados MySQL iremos utilizar a função mysgi query, que possui 
a seguinte sintaxe: 


recurso mysql. query (string consulta [, recurso conexão!) 


Veja um exemplo em que utilizamos a include criada no tópico anterior para 
fazer a conexão com o banco de dados, e logo após executamos um comando 


SQL: 
& exemplo12_1.php 


<?php 
include “conecta mysgl.inc”; 
Sresultado = mysql. query ("SELECT * FROM produtos"); 
mysql. close(fconexao); 

T> 


Capitulo 12 * PHP com banco de dados 163 


Após a execução do comando mysql! query, a variável $resultado conterá um 
ponteiro para o conjunto de registros retornados pelo comando SELECT. Ve- 
remos no próximo tópico como exibir esse resultado na tela, 


Se a sua versão do MySQL for 4.1 ou superior, você deverá mysqli query em 
vez de mysql quety. 


PostgreSQL 


Para executar comandos em um banco de dados PostgreSQL, utilizamos a fun- 
ção pg. query. Sua sintaxe é a seguinte: 


pa.query (recurso conexão, string consulta) 


Podemos atribuir a uma variável uma string contendo um comando SQL, e 
logo após colocar essa string como parâmetro do comando pg. query: Veja 
um exemplo em que utilizamos a include criada no tópico anterior para fazer 


a conexão com o banco de dados, e logo após executamos um comando SQL: 


g exemplo12. 2.php 


<?php 
include “conecta. pg.inc”; 
$sql = “SELECT * FROM produtos”; 
Sresultado = pg. query (Sconexao, $sql): 


pa. close(fconexao); 


?> 


Após a execução do comando pg. query, a variável $resultado irá conter um 
ponteiro para o conjunto de registros retornados pelo comando SELECT. Ve- 
remos no próximo tópico como exibir esse resultado na tela. 


Exibindo os resultados de comandos SOL 


Para tratar as informações retornadas pelos comandos SQL que executa- 
mos, existe uma série de funções que podemos utilizar. Entre O MySQLeo 
PostgreSQL, o que muda são apenas os nomes das funções. A tabela a 
seguir mostra as principais funções para tratamento dos dados, mostran- 


do a descrição, os nomes das funções em MySQL e as equivalentes em 
PostgreSQL: 


164 


Desenvolvendo Websites com PHP 


MySQL PostgresQl Descrição 

mysql. affected. rows pg_affected_rows - Retorna o número de linhas afetadas por 
uma operação. 

mysql fetch array pg. letch array Armazena a linha atual do resultado em um 
array associativo. 

mysql fetch, object pg. fetch object Retorma uma linha como um objeto. 

mysql. feteh, row pg. fetch. row Armazena a linha atual do resultado em um 
array. 

mysql result pg. result Retorna uma coluna do resultado. 

mysql num sows pg. num. rows Retorna onúmero de linhas de uma consulta. 

mysql num. fields pg. num fields Retorna o número de colunas de uma 
consulta. 

mysql. field. name pg.. field name Retorna o nome de uma coluna em uma 
consulta, 


Vamos ver exemplos utilizando os comandos do MySQL. Se você estiver usan- 
do o PostgreSQL, troque o nome dos comandos com base na tabela apresen- 
tada, prestando atenção nos parâmetros de entrada, No site da Novatec Edito- 
ra, os exemplos que veremos estão disponíveis para download, tanto para o 
MySQL como para o PostgreSQL. 


No caso do MySQL, é importante também verificar o número da versão que 
você está usando. No PHP 5 foi adicionada a biblioteca “mysql CUmproved 
MySQL), que deve ser utilizada quando a versão do MySQL for 4.1 ou superior, 
Nesse caso você teria que utilizar, por exemplo, mysqli num rows0ao invés 
de m sql num rowsC ) mysgli fetch array ao invés de mysql fetch artayo, 
e assim por diante. Os exemplos que veremos também estão disponíveis para 
download na versão “mysql”. 


Antes de prosseguir, é importante que façamos a distinção entre as funções 
mysql affected rowse mysql num rows. A primeira é utilizada nas operações 
de inserção (INSERT), atualização (UPDATE) ou exclusão (DELETE), A segun- 
da é utilizada em consultas (SELECT) para obtermos o número de linhas que 
foram retornadas, 


Veja o exemplo de um programa que apaga todo o conteúdo de uma tabela no 
MySQL: 


exemplo12 3.php 


<?php 
include “conecta mysql inc”; 
$resultado = mysql. query (“DELETE FROM produtos"); 


$linhas = mysql affected rows O; 


mysql. close(fconexao); 


echo “<p align=V'centerV'>Foram excluídos $linhas produtos! </p>"; 


2» 


Avariável $/inhas conterá o número de registros afetados pelo DELETE execu- 
tado pelo comando mysgl query. Do mesmo modo podemos utilizar Os CO- 
mandos INSERT e UPDATE. 


Já no comando SELECT, devemos utilizar a função mysql. num rows para des- 
cobrir o número de registros retornados pela consulta. A sintaxe é: 


mysql num.rows (recurso resultado) 


Veja um exemplo: 


& exemplo12. 4,php 


<?php 
include “conecta mysgl incl; 
resultado = mysql. query (“SELECT * FROM produtos"); 
&Vinhas = mysql. num. rows ($resultado); 
mysql. close(fconexao): 


echo “<p align=V'centerV'>A consulta retornou $Vinhas registrosl</p>"; 
p 


T> 


Se em vez de utilizarmos a função mysgl num, rows, utilizássemos a 
mysql num, fields, teriamos o número de campos retornados na consulta. 
Como a tabela produtos possui 8 campos, teríamos como resultado o núme- 
ro8. 


Para obter os valores dos campos retornados por uma consulta, existem diver- 
sas alternativas. Uma delas é utilizar a função mysql result, que possui a se- 
guinte sintaxe: 


mysql.result (recurso resultado, int Tinha [, misto colunal) 


Parâmetro Descrição 


resultado Nome da variável que recebeu o resultado o da função mysql query. 
linha Número da linha que desejamos recuperar (começando em 0). 
coluna Número da coluna (começando em 0) ou nome do campo da tabela. 


Veja o exemplo a seguir, em que exibimos alguns valores da primeira linha 
retornada de uma consulta: 
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Ga exemplo12 5.php 


<?php 
include “conecta mysql, inc”; 
$resultado = mysgl. query ("SELECT * FROM produtos”); 
Scodigo = mysql. result (Sresultado , 0, 0); 
Snome = mysql result (S$resultado , O , “nome produto”); 
ópreco = mysgl.result (Sresultado , O , “preco'); 
mysgl..close(fconexao); 
echo “Código do produto: $codigo <br>"; 
echo “Nome do produto: S$nome <br>"; 


echo “preço do produto: Spreco"; 


?> 


Note que uma vez utilizamos um número para indicar a coluna que devia ser 
retornada, e em outra utilizamos como Índice o nome do campo a ser retorna- 
do. A ordem numérica dos campos é a mesma utilizada no momento da cria- 
ção da tabela. 


Esse programa mostra apenas os campos de um dos registros da tabela. Se 
quisermos, por exemplo, mostrar o nome e o preço de todos os produtos, 
devemos construir um laço, e dentro dele imprimir os valores, conforme mos- 
tra o programa a seguir: 


sa exemplo12. 6.php 


<?php 
include “conecta mysql inc”; 
Sresultado = mysgl.query C SELECT * FROM produtos"); 
Siinhas = mysgl.rnum.rows ($resultado): 
for ($i=0.; $i<$linhas ; $i++) 


{ 
$nome = mysql..result ($resultado , $i , “nome produto"); 
Spreco = mysgl..result (Sresultado , $i , “preco'); 
echo “Nome do produto: nome <br>"; 
echo “Preço: fpreco <br>"; 
} 


mysql. .close($conexao); 


?> 


Outra forma (mais recomendada) de obter os valores retornados de uma con- 
sulta é por meio das funções mysql fetch row e mysql feich array. Essas fun- 
ções colocam as linhas retornadas (uma por vez) em um array, A diferença 
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entre as duas é que a função mysql fetch array permite o acesso 405 indices 
do array por chave associativa (nome dos campos), enquanto a função 
mysql fetch row utiliza somente índices numéricos. A sintaxe básica destas 
funções é a seguinte: 


mysql..feten.row (recurso resultado) 


mysql. fetch.array (recurso resultado) 


O exemplo a seguir imprime os valores de alguns campos da tabela produtos, 
que criamos anteriormente: 


& exemplo12. 7.php 


«<?php 
include “conecta mysgl.inc”; 
$resultado = mysql. query (SELECT * FROM produtos"); 
$Vinhas = mysql. num.rows (Sresultado); 
for ($i=0 ; $i<$linhas ; $i++) 
{ 
$registro = mysql. fetch. romCSresultado); 
echo “código do produto: $registrol0] <br>"; 
echo “Nome do produto: Sregistro[1] <br>"; 
echo “Descrição: Sregistro[2] <br>”; 
echo “preço: Sregistro[3] <br>”; 
echo “Peso: Sregistro[4] <br>"; 
echo “Informações adicionais: $registrol7] <br><br>"; 
} 
mysql. close(fconexao): 


?> 


Avariável $4nhasrecebe o número de produtos existentes na tabela, e é usada 
como limite para o fim do laço determinado pelo comando for. Quando exe- 
cutamos a função mysql fetch row, é criado o array chamado de registro. Por 
meio dos índices desse array obtemos os valores dos campos retornados pela 
consulta, 


A função mysql fetch. row é executada diversas vezes, e a cada execução o 
array registro armazena os valores da linha seguinte do resultado. 


Temos ainda a função mysgl fetch. object, que retorna um objeto que referen- 
cia uma linha do resultado. Sua sintaxe é: 


mysql. fetch object (recurso resultado) 


Devemos utilizar essa função da seguinte maneira: 
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& exemplo12. 8.php 


<?php 
include “conecta mysql. inc”; 
Sresultado = mysql query (“SELECT * FROM produtos”): 
Sobjeto = nysgl..fetch. object CSresultado); 
echo “Nome do produto: “., Sobjeto->nome. produto . "<br>"; 
echo “Preço: “.. Sobjeto-spreco: 


mysql. close(fconexao); 


> 


Depois de aprender todas essas funções, você já pode pegar aqueles formulá- 
rios que vimos em capítulos anteriores, e dar um destino às informações pre- 
enchidas neles, como, por exemplo, incluí-las no banco de dados por meio do 
comando INSERT: No próximo tópico veremos maiores detalhes sobre o ge- 
renciamento de um banco de dados, por meio de inclusões, alterações, exclu- 
sões e consultas. 


Gerenciando um banco de dados com PHP 


Vamos continuar com o exemplo de nossa loja virtual, Em nosso banco de 
dados existem tabelas de produtos; categorias e subcategorias. Para fazer in- 
clusões, alterações e exclusões seria interessante que existisse uma ferramenta 
de gerenciamento desse banco de dados. Essa ferramenta poderia utilizar for- 
mulários HTML e um programa PHP para receber os dados desses formulários 
e efetuar as operações solicitadas, 


Dessa forma você não precisaria entrar pelo Linux (ou outro sistema operaci- 
onal) para ativar seu gerenciador do banco de dados e executar comandos 
SQL sobre ele, Além disso, criando uma ferramenta amigável, qualquer pes- 
soa, sem nenhum conhecimento de comandos SQL poderia manipular as in- 
formações de forma facilitada. 


Então vamos criar uma tela de administração que permite ao administrador 
incluir, excluir ou consultar os produtos cadastrados. Utilizaremos um formu- 
lário para cada uma dessas funções, conforme mostra a tela a seguir: 


ED Adivnianação do Loja Miio oft istenei Inia 


hip ocahon/ivrophp/administahimi 


incluir Produto Excluir Produto 


Código: | Código do produto a ser exctuido: 
Nome de produto 
Descnção do produto: 
Ed 
Preço: T Peso Mostrar Produtos 
Cód Categoria Clique no botão pese exibir todos os 
rodutos da loja 
Cód Subcategoria: Es P 3 
Inf Adrionas 


Figura 12.1 = Formulários para o gerenciamento da loja. 


O código dessa página, que será chamada de administra. html, é apresentado a 
seguir, l 
<html> 
<titte>administração da Loja</title> 
<body> 
«div align="center"> <center> 
«table border="1" celipadding="0" celispacing="0" width="85%" 
bordercolor="8008000" height="348"> 
<tr> 
<td width="23%" bgcolor="4000080" height="19"><p align="center"> 
«font color="SEEFrER” face="arial” size=s"3"><b>Incluir produto</b></font></td> 
«td width="33%" bgcolor="4000080" heighr="19"><p align="center"> 
«font color="SEEFEEE” faces"arial” sizes"3><b>Excluir produto</br</fontr</td> 
</tr> 
<tr> 
<td width=" 33%" rowspan="3" valign="top” height="325"> 
«<form method="POST" action="administra. php”> 
<input type="hidden”. name=" operacao” values”incluir"> 
<p align="center">ênbsp;ênbsp; <br> 


código: <input type="text" name=" codigo" sizes” 5"></p><p align="center"> 
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Nome do produto: <input type="text” names"nome” size="20"></p> 
<p align="center">pescrição do produto: <br> 
«textarea rows="2" name=" descricao" colss"20">e/textareas</p> 


<p align="center"> 


Preço: <inputtypes" text” names" preco” size="10>&nbsp:ênbsp: 
Peso: <input type="text” name="peso” sizes"10"></p> 
<p align="center'>Cód, categoria: <input type="text” name="cc" sizes"4"> 
<br>cód. Subcategoria: <input type="text” names"cs" size="4"></p> 
<p aligne"center">Inf. adicionais: <input type="text” names"ad” size="20"> 
</p>sp align="center"> 
<input type="submit" value="Incluir Produto” name="enviar"></p> 
</form> 
</td> 
<td width="33%” height="175"><p align="center">&nbsp:ênbsp; <br> 
Código do produto a ser excluido: </p> 
<form method="POST” actton="admini stra. php”> 
<input type="hidden" name="operacao” vajues"excluir"> 
<p align="center"><input type="text” names" codigo” sizes"5"></p> 
<p align="center"> 
<input type="submit” value="Excluir Produto” name="enviar"></p> 
</form> 
<p align="center"><br> 
ê&nbsp;ênbsp; 
</td></tr> 
<tr> 
<td width=”33%” bgcolor="#000080" height="22"> 
<p align="center"><font color="grEFrEE” faces"arial” sizes”3"> 
<bsMostrar. Produtos</b> </font> 
«/tdo</tr> 
«tr> 
<td width="338" height="124"> 
<p align="center">ênbsp;ênbsp; <br> 
Clique no botão abaixo para exibir todos os produtos da loja:</p> 
<form method="POST” actions"administra.php”> 
<input type="hidden” names"operacao” values"mostrar"> 
<p align="center"> 
<input type="submit” value="Mostrar Produtos” name="enviar'></p> 
</form> 
<p align="center" »&nbsp: </p> 
</td></tr> 
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</table> 
</center> 
«</div> 
</body> 
</html> 


Agora vamos construir o programa administra php, que é responsável por reali- 
zar todas as operações solicitadas por meio dos formulários descritos anterior- 
mente: Nesse exemplo, vamos utilizar as funções do MySQL. 


administra.php 


<?php 

Soperacao = $. posT|"operacao"]; 

include “conecta mysgl.inc”; 

if CSoperacao=="incluir”) 

í 
fcodigo = $..posTI“codigo"l; 
$nome = $.posTI“nome"]; 
fdescricao = $.posTI "descricao"; 
$preco = £.posTI“preco"]; 
Speso = S.posTI“peso"T; 
$ee = $.rosTItcc"]; 
fes = $f.posTiVes"T; 
Sad 
$sql = “INSERT INTO produtos VALUES “3 


E 


S.post[“ad'; 


$sql = “('Scodigo!, 'fnome!, 'Sdescricao!, fpreco, Speso, Sec, fes, 'Sad')º; 
$resultado = mysql. query ($541); 
echo “Produto incluido com sucessol”; 
+ 
elseif (CSoperacaoe= excluir) 
{ 
fcodigo = $.PoST[«codigo»]; 
$sql = «DELETE FROM produtos WHERE codigo. produto=Scodigo»: 
resultado = mysql. query ($sql); 
$linhas = mysql affected. rowsO; 
1F($linhas==1) 
{ echo “Produto excluido com sucesso!"; } 
else 


{ echo “Produto não encontrado!”; } 
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elseif CSoperacao=="mostrar") 
{ 
$resultado = mysgl query ("SELECT * FROM produtos”): 
$linhas = mysql. num rows ($resultado); 
echo “<p><b>Lista de produtos da loja</b></p>"; 
for ($i=0 ; $i<$tinhas ; $i++) 
{ 
$reg = mysql fetch rom(Sresultado); 
echo “$reg[0] <br>$reg[1] <br>$reg[2] <br>$reg[3] <br>"; 
echo “Sreg[4] <br>$reg[5] <br>$reg[6] <br>$reg[7] <br><br>"; 


} 


mysgl.close(fconexao); 
7> 


Veja que o programa administra php está dividido em três partes: inclusão, ex- 
clusão e visualização de registros, 


Já que os três formulários ativam o mesmo programa, utilizamos o campo Aid- 
den dos mesmos para indicar ao programa qual operação deve ser realizada, 
Em cada formulário existe um campo escondido chamado operacao, que pode 
possui os valores incluir, excluir ou mostrar, conforme o formulário ativado, 


O objetivo deste tópico foi mostrar uma simples tela de administração, para 
facilitar o entendimento da relação entre os formulários e o banco de dados, 
Agora você pode incrementar o programa adaptando-o às suas necessidades, 
fazendo verificação dos campos dos formulários e adicionando novas funcio- 
nalidades, como, por exemplo, a inclusão e exclusão de categorias e subcate- 
gofrias, 


Exemplo utilizando a biblioteca SQLite 


Conforme citado no capítulo anterior, além do MySQL e do PostgreSQL, na 
versão 5 do PHP podemos optar por uma forma mais simples e limitada para o 
armazenamento de dados, Trata-se do suporte à ferramenta SQL embutida cha- 
mada SQLite, que lê e grava dados diretamente em arquivos de bancos de 
dados no disco. 


Se você precisa de velocidade e não necessita de todos os recursos oferecidos 


pelos SGBDs mais completos, o SQLite é uma boa opção. Todas as informa- 
ções sobre essa ferramenta podem ser obtidas no site: 


hep://saqlite org 
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Veremos agora um exemplo de utilização dessa ferramenta, envolvendo des- 
de a criação do banco de dados até a realização de operações (gravação e 
leitura) sobre ele. 


Primeiramente, é recomendável que você acesse o site Atip;//sglite.org € faça 
o download do programa sqlite, que serve para administrar bancos de dados 
SQLite pela linha de comando. É um programa semelhante ao gerenciadores 
mysql e psqi, que vimos no capítulo anterior, e será de grande utilidade na 
criação das tabelas dos seus banco de dados. Esse programa está disponível 
tanto para Linux como para Windows. 


Logo após, iremos criar um banco de dados chamado bdteste, digitando na 
linha de comando do sistema operacional: 


sqlite bdteste 


Executando esse comando, será criado um arquivo chamado bdteste, que irá 
armazenar todos as informações (estrutura € conteúdo das tabelas) referentes 
a esse banco de dados, e será exibido um prompt pata a digitação de coman- 
dos SQL. Exemplo: 


Enter “help” for instructions 


sqlite> 


A partir daí, você já pode executar Os comandos SQL que estudamos no capí- 
tulo anterior. Digitando help, será apresentada uma tela de ajuda, contendo a 


lista de opções do programa, como por exemplo listar os bancos de dados 
Cdatabases), tabelas Ciables) etc. 


O exemplo que veremos consiste na criação de um simples livro de visitas 
(guestbook), onde os visitantes poderão postar suas mensagens contendo 
comentários sobre o seu site, Para armazenar essas mensagens, crie a seguinte 
tabela no sqlite: 


CREATE TABLE mensagens ( 
nome varchar(80), 
cidade varchar (50), 
estado char(2), 
mensagem text 

J; 


Veja que, além da mensagem, serão armazenados nome, cidade e Estado do 
visitante. O formulário de entrada de dados será o seguinte: 


| Livro de visitas 


Nome] ER 
é Cidade: | 
é Estado: [ 

Mensagem: 


Figura 12.2 — Formulário para inclusão de mensagens. 


O código HTML para esse formulário é apresentado a seguir. 


& livro. visitas.html 


<htmi> 

<body> 

<ħl>Livro de visitas</hl> 

<form method="POST” action="livro.visitas.php”"> 
<p>Nome: <input type="text” names"nome” size="20"><br> 
Cidade: <input type="text” name="cidade” size="20"><br> 
Estado: <input type="text” name="estado” size="2"><br> 
Mensagem: <br> 
«textarea rows="3" name="mensagem” cols="30"><«/textarea»<br> 
<input type="submit” value="ENVIAR MENSAGEM” name=" enviar" ></p> 

</form> 

<p>ênbsp; </p> 

</body> 

</html> 


Conforme especificado na opção action da tag <form, os dados desse formu- 
lário serão enviados para o programa fivro. visitas. php: Esse programa deverá 
utilizar as funções do PHP/SQLite para incluir a mensagem no banco de da- 
dos, e posteriormente mostrar a lista das mensagens já incluídas. As principais 


funções do PHP disponíveis para manipulação de bancos de dados SQLite são 
apresentadas a seguir, 


esses omnes 
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Função Desaição 

sqlite open aN Abre um banco de dados SQLite. Se o banco de dados não existir, 
ele será criado. 

sglite_ciose Fecha um banco de dados SQLite. 

sqlite query Executa um comando SQL no banco de dados especificado e 
retorna um ponteiro para o resultado. 

sqlite num rows Retorna à número de linhas resultantes de uma consulta. 

sqlite num fields Retorna o número de campos existentes em um resultado. 

sglite fetch array Obtém a próxima linha do resultado, armazenando-a em um array. 

sglite. changes Retoma o número de linhas que foram alteradas pelo último 
comando SQL executado. 


A função sglite open, responsável pela abertura/criação de bancos de dados 
SQLite, possui a seguinte sintaxe: 


recurso sqlite open (string nome arquivo É, int modo [, string 
&msg. erroil) 


O valor padrão para o segundo parâmetro (modo) é 0666. Se o terceiro pará- 
metro for usado, ele irá armazenar a mensagem referente ao erro ocorrido (se 
houver falha na abertura). Veja que essa função retorna um ponteiro para O 
banco de dados aberto, e portanto seu retorno deve ser atribuído a uma variá- 
vel, que será usada posteriormente nas demais funções. Exemplo: 


$bd = sqlite open('bdteste', 0666, Serro); 


A função sqlite query, utilizada para execução de comandos SQL no banco de 
dados, pode ser usada de duas formas: 


recurso sqlite. query (recurso handle bo, string comandosal) 


recurso sqlite. query (string comandosoL, recurso kandle bd) 


No parâmetro handie bd devemos passar o ponteiro retornado pela função 
sqlite open. Se o comando SQL retornar linhas, essa função retorna um pon- 
teiro para o resultado (result sed, que posteriormente pode ser utilizado pela 
função sglite. fetch. array para leitura dos valores de cada linha. Por exemplo, 


para retornar todos os registros da tabela mensagens e armazenar o primeiro 
deles em um array, teríamos: 


$res = sqlite query(Sdb, ' SELECT * FROM mensagens’); 
Slinha = sglite fetch.arrayíõres); 


Vamos ver então como poderia ser implementado o programa fivro, visitas php, 


: responsável pela gravação de mensagens no banco de dados e exibição de 
| todas as mensagens já gravadas. 


O primeiro teste a ser feito no programa é se o usuário forneceu os seus dados 
(nome, cidade e Estado) e sua mensagem. Se ele forneceu, será realizada a 
gravação desses dados na tabela, para posteriormente as mensagens serem 
exibidas. Se ele não forneceu, o programa irá apenas exibir as mensagens já 
existentes, Será utilizada uma variável de controle ($incluir) para indicar se há 
uma mensagem a ser incluída, Observe o código apresentado a seguir. 


& livro. visitas.php 


<html> 


<body> 

<hi>Livro de visttas<«/hl> 

<?php 

$incluir = 0; 

ifCisset($ POST" nome"]) && isset($ Post" cidade"]) 


&& isset($ poSTI“estado”]) && isser($ POSTI" mensagem”])) 


{ 
Snome = $ POST" nome"]; 
$cidade = $.posTICcidade"]; 
$estado = $_PosT["estado"]; 
$mensagem = $..POST[" mensagem" ]; 
$incluir = 1; 

} 


if ($db = sqlite open('bdteste”, 0666, Serro)) 
{ 
// grava a mensagem recebida 
1fCFincluir) 
sqlite query(Sdb," INSERT INTO mensagens 
VALUES ( Snome',' Scidade',' Sestado!,' $mensagem’ )”); 
/! exibe todas as mensagens 
$res = sglite query(Sdb,' SELECT * FROM mensagens’); 
$Slinhas = sglite num rows($res); 
for($i=0; $i<$linhas; $i++) 
{ 
$linha = sqlite fetch array($res); 
echo “<b>Nome</b>: ".$Vinhal“nome"J, “<br>”; 
echo “<b>Cidade</b>: “.$Vinhal"cidade"J, “<br>”; 
echo “<b>Estado</b>: “.$linhal"estado"J, “<br>"; 


echo “<b>Mensagem</b>: ",$linhal“mensagem"]. “<hr>”; 
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sgqlite close ($db); 


else 
die (Serro); 
T> 
</body> 
</html> 


Se você criou o banco de dados bdteste em outro diretório, não esqueça de 
passar o caminho completo no primeiro parâmetro da função sglíte open. 


Note que o número total de mensagens foi obtido pela função sqlite num, rows, 
e em seguida foi criado um laço para leitura dessas mensagens através da fun- 
ção sqlite fetch array. A figura 12.3 mostra um exemplo de exibição das men- 
sagens gravadas no banco de dados. 


F bop Moratosti inopi ivo vinia pho Mitiasolt lelene! Explo 


Livro de visitas 


Nome Silvio Santos 
Cidade: São Paulo 
Estado: SP 
Mensagem: Seu ste está muto bom! Meus parabéns! 

Nome João Siva da Siva 

Cidade: Rio de Janeiro 

Estade: RJ 

Mensagem Este é um dos melhores sites que já matei Sou estudante de Biogeografia Antropológica 
Sistêmica Magnetzada Anamóriica, e sempre quando necesmto de uma ajuda, acesso este site, Parabéns 
aos autores! 


Name: Ricardo Gomes da Silva 

Cidade: São Paulo 

Estado: SP 

Mensagem: Adorei o site de vocês! É uma pena que a seleção brasileira de Atebol do Brasi ficou de fora 
dos jogos olimpicos. Agora teremos que esperar até 2008 para disputar uma medalha de ouro na Chisal 


Figura 12.3 — Exibindo as mensagens do livro de visitas. 


Na referência das funções, ao final deste livro, você irá encontrar a descrição 
das demais funções da biblioteca SQLite. 
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Cookies e sessões 


Se você precisa manter informações sobre seus usuários enquanto eles nave- 
gam pelo seu site, ou até quando eles saem do mesmo, é importante que você 
saiba lidar com cookies ou com sessões. Cookies são arquivos-texto que po- 
dem ser armazenados no computador do usuário, para serem recuperados 
posteriormente pelo servidor no qual seu site está hospedado. Sessões são 
recursos que podemos utilizar para manter uma conexão com o usuário, en- 
quanto ele estiver navegando no site. Veremos com detalhes esses dois meca- 
nismos nos próximos tópicos. 


Algumas utilidades de cookies e sessões 


Quando você acessa uma página Web, a comunicação entre o seu programa 
navegador e o servidor Web é feita através de um protocolo chamado HTTP 
(Hypertext Transfer Protocol). O problema é que esse protocolo não armaze- 
na informações de estado, ou seja, ele trata de forma independente cada requi- 
sição de página que recebe. 


Por exemplo, se você acessar as páginas chamadas teste l. htmlfe teste2.himl e 
outra pessoa acessar essas mesmas páginas, o servidor irá tratar esses acessos 
como sendo 4 requisições independentes. Ele não irá saber que foram 2 pes- 
soas que acessaram 2 páginas cada. Por essa razão é que os mecanismos de 
cookies e sessões são importantes, pois eles nos permitem armazenar infor- 
mações que poderão ser utilizadas enquanto o usuário estiver navegando en- 
tre as páginas do nosso site. 


Entre algumas utilidades de cookies e sessões, podem ser citadas: 


* Autenticação de usuários: criação de um sistema envolvendo login, auten- 


ticação e logout, O que garante o acesso do conteúdo somente aos usuári- 
os autorizados, 


$ 
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Carrinho de compras: utilizado nos sites de comércio eletrônico para ar- 
mazenar todos os produtos já selecionados pelo cliente para compra, en- 
quanto ele navega pelo site da loja. 


Exibição de anúncios ou imagens: para não exibir mais de uma vez um 
mesmo anúncio ou imagem para o usuário, é necessário manter informa- 
ções sobre as que já foram exibidas. 


Personalização de páginas: por exemplo, uma livraria virtual poderia exi- 
bir o anúncio de um livro de culinária, caso o usuário tivesse feito uma 
pesquisa pela palavra “culinária” na última vez que acessou o site, 


Essas são apenas algumas das aplicações que podem ser implementadas com 
o uso de cookies ou de sessões. 


Utilizando cookies 


Cookie é um arquivo-texto que podemos armazenar no computador do usuá- 
rio, para ser recuperado posteriormente pelo servidor. Um cookie é formado 
por um par nome/valor, ou seja, possuí um nome pelo qual ele é referenciado 
e um valor associado a esse nome, Podem ser utilizados em qualquer aplica- 
ção que necessite compartilhar dados entre diferentes páginas, ou até entre 
diferentes acessos (em dias e horários distintos). 


Os cookies podem ser mantidos na máquina do usuário por vários dias, ao 
contrário das sessões, que mantêm os dados somente enquanto o usuário per- 
manecer no seu site, 


Enviando cookies pelo PHP 


O PHP nos oferece a função setcookie, que envia cookies para o computador 


do usuário. Essa função é usada tanto para definir um cookie, como também 
para excluí-lo, Sua sintaxe é a seguinte: 


bool setcookie (string nome L, string valor L, int validade L, 
string caminho [, string dominio E, int seguro) 


Parâmetro Descrição 


nome Indica o nome do cookie que está sendo enviado, e é o único parâmetro 
obrigatório para a função. 

valor É o valor do cookie. Se não for fornecido, o servidor tentará excluir o cookie 
com o nome especificado. 

validade Define o tempo de validade do cookie. Deve ser expresso no formato-padrão 


de tempo do Unix (número de segundos após 1º de janeiro de 1970, às Oh). 
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Parâmetro Descrição (cont.} 


caminho Caminho no servidor para o qual o cookie estará disponível. Se for definido 
ovalor"”, ele estará disponivel para todo domínio especificado no parâmetro 
dominio. Q valor padrão é ọ diretório corrente a partir do qual o cookie foi 


definido. 
dominio Domínio para o qual o cookie estará disponivel. 
seguro É um valor inteiro (0 ou 1), que indica se o cookie é seguro. Se for utilizado 


o valor 4, o cookie só será transmitido se a conexão for segura (HTTPS). 


Se for utilizado somente o parâmetro nome, o servidor tentará excluir o cookie 
do computador do usuário. Portanto, para definir um cookie devemos utilizar 
no mínimo os parâmetros nome e valor. Exemplo: 


non 


setcóokie ("nome”,"Jutiano”):; 


Para excluir o cookie criado anteriormente basta executar o comando: 


setcookie (“nome”); 


Para criar, por exemplo, um cookie válido por 2 dias (48 horas) podemos utili- 
zar como auxílio a função time do PHP. Exemplo: 


setcookie (“nome”, “Juliano”, time0+172800); 


Esse cookie é válido por 2 dias, pois utilizamos a função time para obter o 
tempo atual, e somamos 172.800 segundos, que equivalem a 48 horas. Esse 
resultado foi passado como o parâmetro validade para a função setcookie. 


Caso você não queira passar algum parâmetro intermediário, utilize uma string 
vazia (O para substituí-lo, com exceção dos parâmetros validade e seguro, pois 
estes devem conter valores numéricos. Nesse caso utilize zero (0) em vez de *”, 


O array superglobal $ COOKIE 


Agora que você já aprendeu a enviar cookies para o computador do usuário, 
vamos ver como recuperar esses valores em seus programas PHP, Após defini- 
dos, os cookies estarão disponíveis para toda a requisição de páginas feita 
pelo usuário ao servidor. É importante lembrar que os cookies não poderão 
ser utilizados dentro da própria página que os criou. Poderemos utilizá-los 
somente a partir da próxima solicitação de página vinda do browser do usuá- 
rio. 
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Existem duas formas de acessar, por meio do PHP, os cookies enviados para a 
máquina do usuário. Uma delas, e a mais recomendada, é através do array 
superglobal $. COOKIE (em versões mais antigas era chamado de 
SHTTP. COOKIE. VARS). Devemos utilizar o nome do cookie como chave as- 
sociativa desse array. Por exemplo, se você definiu um cookie chamado nome: 


setcookie ("nome”,” Juliano”); 
Na próxima página acessada pelo usuário, esse valor poderia ser acessado da 
seguinte maneira: 


$ COOKIE [ nome”] 


A segunda forma de acessar o valor de um cookie funciona apenas se a direti- 
va register. globalsestiver habilitada no pAp.ini. Nesse caso, você pode utilizar 
o próprio nome do cookie como uma variável. Por exemplo, o cookie nome 
seria referenciado pela variável $nome. 


Criando um sistema de username/senha para seu site 


Esses sistemas são utilizados em diversos tipos de sites. Alguns utilizam para 
proteger um conteúdo que não é gratuito, permitindo o acesso somente de 
usuários autorizados. Atualmente até alguns sites que possuem um conteúdo 
gratuito estão exigindo um cadastramento de usuários, a fim de conhecer o 
perfil das pessoas que os acessam. 


Veremos agora como criar um sistema de username/senha para seu site, utili- 
zando um banco de dados para armazenar as informações dos usuários e cooki- 
es para implementar a autenticação, O sistema será dividido em três partes: 


1) Página de login, que recebe os dados do usuário, verifica se ele está cadas- 
trado e cria os cookies. 


2) Rotina de validação para ser utilizada nas páginas que fazem parte das áre- 
as restritas, 


3) Página de logout para os usuários que estão autenticados (realizar exclusão 
dos cookies). 


A primeira coisa a ser feita é criar uma tabela no banco de dados para armaze- 
nar os dados dos usuários, Vamos utilizar como exemplo uma tabela que ar- 
mazena nome, e-mail, cidade, Estado, nome de usuário (username) € senha 
do usuário, Essa tabela será criada por meio do utilitário mysql! (ou psqh no 
caso do PostgreSQL), através da digitação do seguinte comando SQL: 
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Login 


CREATE TABLE usuarios 

( 
username varchar(10) NOT NULL, 
senha varchar(10) NOT NULL, 
nome varchar (80) NOT NULL. 
email varchar(80) NOT NULL, 
cidade varchar(40) NOT NULL, 
estado char(2) NOT NULL, 
primary keyfusername) 


3 


Repare que utilizamos o campo username como chave primária (Primary Key), 
pois isso nos garante que não poderá haver nenhum username repetido em 
nosso banco de dados. Portanto, cada usuário possuirá uma identificação úni- 
ca, que será armazenada no campo username. 


Após a criação da tabela, você pode utilizar os conhecimentos adquiridos nos 
capítulos 8 e 12, para criar um formulário de cadastramento de usuários. Basta- 
ria criar um formulário com os campos listados anteriormente, e enviar os re- 
sultados para um programa PHP que realizasse a inclusão na tabela de usuári- 
os por meio do comando SQL INSERT. 


Como o objetivo desse tópico é ensinar a autenticação, vamos considerar que 
o banco de dados já possui alguns usuários cadastrados. Se você ainda não 
criou um formulário de cadastro e quiser testar a autenticação, pode incluir um 
registro apenas para fins de teste, digitando diretamente no mysg/(ou psgh: 


INSERT INTO usuarios VALUES 
Cjuliano', 'teste”, JULIANO”, 'juliancêniederaver.com.br','Porto Alegre", 'RS'); 


Após a criação da tabela e inclusão de alguns usuários, o próximo passo é 
fazer um programa de login, que recebe o username e a senha de um usuário, 
verifica se essas informações estão corretas, cria os cookies no computador do 
usuário e o direciona para a página inicial para usuários do site. 


Vamos supor que na página inicial de seu site há um formulário com dois cam- 
pos (username e senha) para o usuário fazer seu login, conforme mostra a 
figura 13.1, 
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Nome de usuário: | 
Senha: | | 


Figura 13.1 — Formulário de login. 


O código dessa página, nomeada como login html, é o seguinte: 


& login.html 


<html> 
<body> 
<form method=" Post" actions" login. php”> 
<p align="center”>Nome de usuário; 
<input type="text" name="username" sizes”10"></p><p align="center"> 


senha: <input type="password" name=" senha” sizęs”10"></p> 


<p align="center"><input type="submit” values"Enviar” name=" enyiar” ></p> 
</form> 
</body> 
</html> 


Ao clicar no botão “Enviar”, será ativado o programa /ogin. php, que deve ana- 
lisar as informações enviadas e retornar uma resposta para O usuário ou direci- 
oná-lo para outra página. 


Vamos agora construir o programa login. php, que primeiro deve verificar se o 
usuário realmente está cadastrado e se a senha digitada está correta, para pos- 
teriormente criar os cookies. Para acessar o banco de dados utilizaremos a 
include conecta mysglinc, criada no capítulo anterior, Se você desejar, no site 
da Novatec Editora (no endereço indicado no início deste livro), você poderá 


obter esse mesmo programa utilizando as funções do PostgreSQL ao invés do 
MySQL. 


& login.php 


<?php 
// obtém os valores digitados 
$username = $ PosT{["username"]; 


$senha = $ PosT["senha"]; 


// acesso ao banco de dados 

include “conecta mysql inc”; 

resultado = mysql. query (SELECT * FROM usuarios where usernames’ fusername O; 
$linhas = mysgl. num rows (fresultado); 


4f(SVinhas==0) // testa se a consulta retornou algum registro 


{ 
echo “<htmi><body>"; 
echo “<p align=V'centerV'>usuário não encontrado! </p>"; 
echo “<p align=V'centerV ><a href=" login.him|V'>voltare/a=</p>"; 
echo “</body></htmi>": 
} 
else 
{ 
if Cisenha != mysql-result($resultado, O, “senha")) // confere senha 
{ 
echo “<hemi><body>"; 
echo “<p align=center V'>A senha está incorretal</p»"; 
echo “ep align="centerV'><a href= Togin.htmIV">voltar</a></po"; 
echo “</body></html>"; 
> 
else // usuário e senha corretos. Vamos criar os cookies 
{ 
setcookie(“nome usuario”, $username); 
setcookie(“senha usuario”, $senha); 
// direciona para a página inicial dos usuários cadastrados 
header (Location: pagina.inicial.php"); 
} 
} 


mysql. close($conexao); 


7» 


Veja que primeiro foi feita uma consulta ao banco de dados para verificar se o 
usuário existe. Se não existir, é exibida a mensagem “ Usuário não encontrado”, 
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Se existir, a senha digitada é comparada com a senha gravada no banco de 
dados e, se elas forem iguais, o login é realizado através da criação dos cookies 
e direcionamento do usuário à página principal, 


Nesse exemplo, foi considerado que a página principal do seu site (depois do 
login) se chama pagina inicial php. Se você for utilizar páginas com outros 
nomes, apenas faça a substituição desse nome, 


Autenticação 


Depois que o usuário fez o login, os cookies já foram armazenados na máqui- 
na dele. Agora a cada página que ele for acessar, devemos verificar se os cookies 
realmente existem ese contêm as informações corretas. Devemos fazer isso 
para evitar que o usuário digite diretamente o endereço de uma página, sem 
passar pelo login. 


Para fazer essa verificação e validação dos cookies, vamos criar uma include 
chamada valida cookies.inc, que deve ser chamada por todas as páginas que 
devem ser protegidas. 


Acompanhe então o código apresentado a seguir. Note que nas primeiras li- 
nhas, antes de obter o valor dos cookies, testamos se eles realmente estão 
definidos através da função IsSetdo PHP. É recomendável fazer esse teste para 
evitar que o PHP exiba alguma mensagem de erro ao tentarmos acessar um 
elemento que não existe no array £ COOKIE 


e valida  cookies.inc 


<?php 
if(Isset($..COOKIE[ “nome usuario"])) 

$nome usuario = $ COOKIE" nome usuario"); 
if(Isset($..C00KTE[ “senha usuario"])) 


$senha usuario = $.COGKIE[ “senha usuario"]; 


TEC (empty (Snome usuario) OR empty(fsenha usuario))) 
{ 
include “conectamysgl. inc”; 
$resultado = mysql. query(CSELECT * FROM usuarios 
WHERE username=' fnome usuario"): 
if (mysql. num rows($resultado) ==1) 
{ 
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ra dai 


if(isenha usuario l= mysql. result(Sresultado,0,"senha”)) 


{ 
setcookie( nome usuario"); 
setcookie('senha usuario"); 
echo “você não efetuou o LOGIN!"; 
exit; 
} 
} 
else 
{ 
setcookie(“nome usuario"); 
setcookie(" senha usuario”); 
echo “você não efetuou o LOGINI"; 
exit; 
} 
} 
else 
t 
echo “você não efetuou o LOGIN!”; 
exit; 
} 


mysql. close(fconexao); 

7> 
Esse programa verifica a existência e a validade dos cookies. Caso eles não 
existam, é mostrada a mensagem “ Você não efetuou o LOGIN". Se os cookies 
existirem, mas forem inválidos, eles serão excluídos pela função setcookie, e 
será mostrada a mesma mensagem, informando que o login deve ser feito. 


Agora basta colocar uma chamada para essa include no topo de todas as pági- 
nas que devem ser protegidas: 


include “valida cookies inc”; 


è 


Dica: Como os cookies são arquivos-texto, qualquer pessoa pode descobrir onde eles está 
armazenados e visualizar seu conteúdo. Por isso seria interessante armazenar a senha do usuário 
de forma criptografada em um cookie. Para criptografar um dado devemos utilizar a função crypt 
do PHP. A crypt é uma função que não tem volta, ou seja, não podemos decodificar um dado que 
foi criptografado. Portanto, no momento de fazer uma comparação com a senha do banco de 
dados, esta também deve ser criptografada antes de testarmos se as duas são iguais. 


O próximo tópico mostra como proceder quando o usuário vai sair do site, ou 
seja, quando ele vai efetuar um logout, 
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Para o sistema de username/senha ficar completo só está faltando a constru- 
ção de um programa de logout do usuário, Esse programa é importante por- 
que o usuário pode querer continuar navegando por outros sites, ou seja, O 
browser dele continua aberto, mas ele continua “logado” em seu site, embora 
não o esteja mais utilizando. Em muitos lugares um computador é utilizado 
por mais de uma pessoa, e se não houver um programa de logout, pode ocor- 
rer de uma pessoa pegar uma conexão que a outra deixou aberta, e acessar 
uma área restrita de seu site, 


O programa de logout nada mais é do que a exclusão dos cookies criados no 
momento do login, que armazenam a senha e o nome de usuário: 


a logout.php 


«<?php 
setcookie('nome usuario"): 
setcookie('senha usuario"): 


header (“Location: login html“); 


?> 


Esse programa exclui os cookies nome usuario e senha, usuario, e redirecio- 
na o browser para a página de login. A partir desse momento o usuário só 
poderá acessar o site se fornecer sua identificação novamente, 


Podemos colocar em todas as páginas do site um link para que o usuário possa 
fazer o logout a qualquer momento: 


<a bref="Togout.php'>LOGOUT</a> 


Por exemplo, sua página inicial poderia ter a seguinte estrutura, incluindo a 
chamada para a include de validação e um link para realizar o logout, 


(sa pagina. inicial. php 


<?php 

include “valida cookies. inc”; 

?> 

<html> 

<body> 

seja bem-vindo ao meu sitellI<br> 

Coloque o conteúdo do seu site aqui neste espaço. <br> 
<p><a href="logout.php”>LOGOUT</a></p> 

</body> 

</html> 


Dessa forma, se o usuário tentasse acessar pelo browser diretamente O arquivo 
pagina inicial php, sem passar pelo login, o sistema de autenticação não iria 
permitir a visualização da página. 


Utilizando sessões 


Uma sessão é um período de tempo durante O qual uma pessoa navega pelas 
páginas de um site. Quando um usuário entrar no site, podemos abrir uma 
sessão e nela registrar diversas variáveis, que ficarão gravadas em arquivos no 
servidor e poderão ser acessadas em qualquer página do site, enquanto à ses- 
são estiver aberta. 


Cada sessão terá um número identificador único, chamado de session id. Para 
uma página ter acesso aos dados da sessão, ela deve conhecer esse identifica- 
dos Para transmitir o identificador da sessão entre as páginas, existem duas 
formas: 


e Cookies 
* Propagação de variáveis na URL (endereço destino) 


A primeira forma consiste em armazenar o identificador da sessão em um cookie 
na máquina do usuário, € utilizá-lo como referência para acessar os dados da 
sessão no servidor, Esse é o melhor método, e por padrão está habilitado pela 
diretiva session.use. cookies do arquivo php.ini. Porém, como ele nem sem- 
pre está disponível (o usuário pode desabilitar os cookies), pode ser utilizado 
o segundo método como alternativa. 


O segundo método consiste em propagar O identificador da sessão por meio 
da URL, o que pode ser feito de duas formas. Se no momento da compilação 
do PHP foi ativado o parâmetro --enable-trans-sid, a identificação da sessão 
será enviada transparentemente entre as páginas. Caso contrário, devemos 
acrescentar 20 final da URL a constante S/D, que o PHP cria automaticamente 
no início de uma sessão. Por exemplo: 


echo '<a href="pagina.php?'. SID ."">Clique aqui</a>"; 


Sempre que possível utilize o primeiro método (cookies), pois além de ofere- 
cer um melhor gerenciamento da sessão, também é muito mais recomendado 
em termos de segurança. 
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Criando uma sessão no PHP 


No PHP uma sessão pode ser criada de forma manual ou automática, A criação 
manual pode ser feita de forma explícita (função session, start) ou de forma 
implícita (ao registrar uma variável com a função session register). A forma 
automática consiste em habilitar a diretiva session. auto .startdo arquivo php.ini. 
Assim, sempre que um usuário entrar em seu site será automaticamente criada 
uma sessão, 


A função session, start serve tanto para criar uma sessão como para restaurar 
os dados uma sessão com base no identificador corrente (passado pelo méto- 
do GET, POST ou por cookie). Essa função não possui parâmetros. 


bool session start (vazio) 


Se você estiver usando o método dos cookies para armazenar o identificador 
da sessão, deve chamar a função session startantes de qualquer saída produ- 
zida pelo browser. 

<?php 


session start(); 


?> 


Registrando variáveis em uma sessão 


Ao registrar uma variável em uma sessão, estamos tornando-a disponível para 
todas as páginas que serão acessadas até o término dessa sessão, Existem duas 
formas de registrar uma variável; 


* utilizando a função session register, que permite registrar uma ou mais va- 
riáveis na sessão corrente. 


bool session. register (misto nome [, misto...]) 
* adicionando diretamente entradas ao array superglobal $ SESSION, 


A segunda alternativa é mais recomendada, pois a primeira pode apresentar 
problemas caso a diretiva register. globais do php.ini esteja desabilitada. O ar- 
ray $ SESSION está disponível desde a versão 4.1.0 do PHP, Para versões ante- 
riores pode-se utilizar o $H7TTP SESSION, VARS. 


Se você utilizar O array $ SESSION, não será necessário usar funções como 
session tegister, session unregister e session, is. registered. Vamos ver alguns 
exemplos de registro de variáveis. Acompanhe o código a seguir. 


<?php 

session startQ:; 

if (Isset($_SESSION[' contador" ])) { 
$_sesston[ contador] = 1; 

} else { 
$ SESSION[ contador" J++; 


; 


P> 


Nesse código, uma sessão é inicializada com a função session, start, e logo 
após é utilizado o comando isset (Us Set, ou seja, está definido) do PHP para 
ver se a variável de sessão chamada contador já existe. Se não existir, ela é 
criada com o valor 1, caso contrário seu valor atual é incrementado. 


Vejamos agora outro exemplo. Para testar O registro de variáveis em uma ses- 
são e o uso desses valores em outra página, vamos criar duas páginas. chama- 
das paginal.php e pagina2. php. Na primeira, serão definidas três variáveis de 
sessão e será exibido um link para a segunda página. Na segunda, serão exibi- 
dos os valores dessas três variáveis por meio do comando echo do PHP, O 
código da primeira é o seguinte. 


& pagina1.php 


<?php 

session start: 

echo ‘Esta é a primeira página”; 

$ _SESSION[ nome'] = *Juliano": 

$ SESSION! ' sobrenome") = ‘Niederauer’; 

$ session[ data!) = date('d/m/Y, time): 
echo ‘<br><a href="paginaZ.php">Página 2</a>'; 


?> 


Após iniciar a sessão, as variáveis nome, sobrenome e data foram registradas 
por meio de uma atribuição direta aos seus respectivos elementos no array 
$ SESSION, Logo após foi exibido um link para a segunda página, que irá 
mostrar esses valores na tela, Nesse exemplo, estamos supondo que está em 
uso o mecanismo dos cookies para propagação do identificador da sessão. 
Porém, se você estiver propagando o identificador através da URL, pode exibir 
o link usando a constante SID, da seguinte forma. 


echo ‘<br><a href="paginaZ.php?'. SID ."">Página 2</a»"; 
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Na segunda página, basta restaurar os dados da sessão com o comando 
session_start e exibir os valores das variáveis, acessando novamente o array 
$ SESSION. Acompanhe o código apresentado a seguir. 


&» pagina2.php 


<?php 
session. starti); 
echo 'Esta é a segunda página <br>": 


echo $..sEssION['nome'] . “<br>”; 


| 


echo $. SESSION[ ' sobrenome! . “<br>”: 
echo $ SESSION[ data'] . “<br>”; 
echo '<br><a href="paginal.php'>página 1l</a>'; 


F> 


Caso você não vá mais utilizar alguma variável da sessão nos próximos aces- 

sos, é possível eliminá-la, Se a diretiva register. globais do php. ini estiver desa- 

bilitada, isso pode ser feito pelo comando unset do PHP, Exemplo: 
unset($SESSION[ “nome” 1); 

Se a diretiva register globais do php.ini estiver habilitada, então você pode 

eliminar uma variável de sessão por meio da função session unregister, Exem- 


plo: 


session unregister('nome'); 


Parâmetros de configuração 


O gerenciamento das sessões pode ser configurado por meio do arquivo 
php.ini, que é um arquivo de configuração do PHP. Veja na tabela a seguir os 
principais parâmetros disponíveis: 


Parâmetro Descriçã 

session.save handler Nome do manipulador para armazenar e recuperar dados 
de uma sessão. O padrão é files. 

session.save path Parâmetro que será passado para a rotina de 
armazenamento (ex: diretório onde serão criados os 
arquivos). 

session.name Nome da sessão. O valor-padrão é PHPSESSID. 

session.auto start Define se uma sessão deve ser iniciada automaticamente 
quando houver uma requisição do usuário. O padrão é 0. 

session. serialize handler Define como os dados da sessão serão serializados, O 


padrão é php, um formato interno do PHP, 
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Descrição (cont.) 


session.ge probability 
session.gc. maxiifetime 
session. referer check 


session.entropy. file 


session.entropy. length 


session use cookies 


session. use, only cookies 


session.cookie, lifetime 


session cookie. path 
session.cookie. domain 
session cookie secure 


session.cache. limiter 


session. cache expire 


session.use frans sid 


session. bug. compat 42 


session bug compal warm 


url rowritor. tags 


Define a probabilidade (em percentual) de execução da 
rotina ge (garbage collection) a cada requisição. 


Número de segundos que deve ser esperado para que os 
dados armazenados sejam descartados. 


Permite definir uma substring para verificar se ela esta 
contida na requisição HTTP. 


Caminho para um recurso externo (arquivo) que será 
usado no processo de criação do identificador da sessão. 
Exemplo: Mdev'random. 


Número de bytes que devem ser lidos a partir do recurso 
especificado no parâmetro session, entropy. file. 


Indica se serão utilizados cookies para armazenar O 
identificador da sessão na máquina do usuário. O padrão 
é 1 (habilitado). 


indica se devem ser usados somente cookies para 
armazenar o identificador da sessão. É usado para prevenir 
possiveis ataques de passagemi do identificador através 
da URL. O padrão é O (desabilitado). 


Define em quanto tempo (em segundos) os cookies 
enviados expiram. O padrão é 0, ou seja, até que O 
browser seja encerrado. 


Define o caminho no qual o cookie é válido. O padrão é. 
Define o dominio no qual o cookie é válido. 


Se habilitado, os cookies serão enviados apenas se a 
conexão for segura (HTTPS). 


Define o método de controle de cache usado para as 
páginas da sessão. O padrão é nocache. Quiros valores 
possiveis são none, private, private no expire e public. 


Especifica o tempo (em minutos) de validade para as 
páginas de sessão armazenadas na cache. Só tem efeito 
se o método utilizado não for o nocache. O padrão é 180. 


Indica se a propagação transparente do identificador da 
sessão está habilitada. O padrão é 0 (desabilitada). 
Permite desabilitar uma caracteristica da versão 4.2 do 


PHP, que possibilita inicializar variáveis de sessão no 
escopo global, 


É complementar ao parâmetro anterior. Indica se deve ser 
exibido um aviso caso o usuário tente usar essa 
caracteristica. 


Define as tags HTML que devem ser reescritas para 
inclusão do identificador de sessão, quando o modo 
transparente estiver habilitado. 
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Usando sessões no sistema de username/senha 


Se você desejar, pode alterar o sistema de username/senha apresentado no 
tópico sobre cookies, para que ele passe a utilizar sessões. Para isso, são ne- 
cessárias apenas algumas modificações nos arquivos de login, autenticação e 
logout. 


Por exemplo, ao invés de criar dois cookies no momento do login (arquivo 
login php), deveriam ser registradas duas variáveis de sessão, ou seja, ao invés 
de: 


setcookie(“nome usuario”, Susername): 


setcookie(“senha usuario”, Ssenha); 
teríamos o seguinte: 


session.startó): 
$.SESSION[' nome usuario'] = $username; 


S.SESSION[ ‘senha usuario'] = $senha; 


Na etapa de autenticação (arquivo valida cookies. inc), deveríamos verificar o 
valor das variáveis de sessão ao invés dos cookies, ou seja, bastaria substituir o 
array $, COOKIE pelo & SESSION. Porém, lembre-se que sempre é necessário 
restaurar os dados da sessão atual utilizando a função session, start. Portan- 
to, alterando o nome do array nas primeiras linhas do nosso script de autenti- 
cação, teriamos o seguinte código; 
session. start); 
ifCIsset(s. SESSION[ "nome. usuario”) 
fnome usuario = $. SESSION[ “nome usuario"]; 
if (1sSet($ SESSION[" senha usuario") 
Ssenha.usuario = $ SESSION[" senha usuario"); 
Outra parte da rotina de autenticação que deveria ser alterada é a exclusão dos 
cookies. No caso das sessões, isso equivale a eliminar as variáveis de sessão 
nome. usuário e senha usuario, Portanto, as linhas: 
setcookie(“nome usuario"): 


setcookie(“senha usuario"); 
deveriam ser substituídas por: 


unset ($ SESSION[ nome. usuario D: 


unset ($ SESSION[' senha usuario']); 


Por fim, deveríamos alterar a rotina de saída do usuário do site Uogout php), 
fazendo-a utilizar a função session destroyQ do PHP, que elimina todos os 
dados de uma sessão, É importante destacar que essa função apenas encerra a 


sessão, mas não libera o espaço alocado para as variáveis registradas. Para eli- 
minar essas variáveis, se você estiver usando o array 4 SESSION, basta reini- 
ciá-lo atribuindo-lhe um array vazio: 


$. SESSION = array(D; 


Caso contrário, utilize a função session, unsetO), que tem a mesma finalidade. 
Veja então no código a seguir como poderia ser o programa de logout de usu- 
ários com o uso de sessões. 


<?php 

session. start! 

$ SESSION = array; 

session destroyQ): 

header CLocation: login html”); 

?> 
Esse programa encerra a sessão atual, elimina todas suas variáveis e redirecio- 
na o usuário de volta para a página principal de seu site. A partir daí, ele só 
poderá acessar o conteúdo do site se fizer o login novamente, Note que, antes 
de destruir a sessão, foi necessário chamar a função session start para restau- 
rar o ambiente da sessão atual. 
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Manipulando arquivos em PHP 


Além de utilizar um SGBD (Sistema Gerenciador de Banco de Dados), como o 
MySQL e o PostgreSQL, existe outra forma de armazenar dados para recuperá- 
los posteriormente. O PHP oferece uma série de funções para trabalharmos 
com o sistema de arquivos do sistema operacional. Podemos abrir, fechar, ler, 
escrever e realizar diversas outras operações sobre um arquivo de formato 
conhecido, não necessitando que haja um SGBD instalado no servidor. Vere- 
mos neste capítulo em quais situações é interessante realizar a manipulação 
de arquivos, e conheceremos os principais comandos para essa tarefa. 


sena mera 


| Quando utilizar arquivos no PHP 


Em aplicações que exigem o armazenamento de poucos dados, às vezes não 
há a necessidade de utilizar um SGBD para armazená-los, pois isso torna O 
processo mais lento, visto que deve haver uma conexão com o banco de da- 
dos para realizar uma consulta, Se O servidor de banco de dados estiver locali- 
zado em um outro host (outro servidor da rede), a situação se agrava, pois a 
rede pode estar congestionada. Nesses casos podemos trabalhar, por exem- 
plo, diretamente com arquivos no formato texto, o que torna mais rápido o 
processo de armazenamento e recuperação de dados. 


Entre as situações em que podemos utilizar a manipulação de arquivos em vez 
de um SGBD, podem ser citadas: criação de contadores de acessos para uma 
ou mais páginas do site, criação de um programa gerenciador de publicidade 
online (anúncios por meio de banners) e criação de fóruns de discussão ou 
livro de visitas (guestbook). 


Em todos os exemplos citados os dados podem ser armazenados em simples 
arquivos no formato texto. É claro que não vamos utilizar esse tipo de arquivos 
para armazenar os dados dos usuários do site, pois além disso não oferecem a 
segurança necessária e a manipulação desses dados (inclusão, alteração e ex- 


Funções para manipulação de arquivos 


fopen 
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clusão) fica extremamente dificil. É recomendado o uso de arquivos somente 
quando o volume de dados for pequeno, evitando assim que seja perdido tempo 
com a utilização de um SGBD para realizar uma tarefa simples. 


Essas funções são responsáveis pelas diversas operações que podemos reali- 
zar sobre os arquivos. O PHP nos oferece dezenas de funções capazes de tra- 
balhar com o filesystem (sistema de arquivos) do sistema operacional, As prin- 
cipais operações que podemos realizar sobre um arquivo são: abertura, leitu- 
ra, escrita e fechamento. Portanto, veremos com maiores detalhes as funções 
que realizam essas tarefas. 


Para abrir um arquivo, utilizamos a função pen, que possui a seguinte sinta- 
xe: 


recurso fopen (string nome arquivo, string modo [, int 
usar. include path |, recurso contextol) 


Parâmetro Descrição 


nome arquivo Nome do arquivo a ser aberto, que pode ser local ou remoto. Se for 
fomecidoum URL, aabertura só irá luncionar se a diretiva allow_url_fopen: 
estiver habilitada no php.ini. 


modo Modo de acesso ao arquivo. A lista dos modos disponiveis setá 
apresentada logo a seguir. 


usar include. path . Indica se o arquivo deve ser procurado nos diretórios especificados na 
diretiva include. path do php.ini. 


contexto Permite a definição de um contexto, que consiste em um conjunto de 
parâmetros que modificam o comportamento do arquivo. O suporte a 
contextos foi adicionado no PHP 5. 


O parâmetro nome arquivo pode referenciar um arquivo que está no mesmo . 
computador ou em um computador remoto. Se esse parâmetro iniciar com | 
“ftp”, será aberta uma conexão HTTP, que retornará um ponteiro para o - 
arquivo que foi aberto, Se o nome do arquivo iniciar com “ftp://”, será aberta — 
uma conexão FTP antes da abertura do arquivo, 


Se a abertura não necessitar do estabelecimento de uma conexão HTTP ou | 
FTP, o arquivo será aberto do filesystem da própria máquina, e será retornado 
um ponteiro para esse arquivo, A função pen retorna o valor falso se a aber- | 
tura do arquivo falhar, 
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O segundo parâmetro da função fopen é o modo, que pode possuir os seguin- 
tes valores: 


Modo Descrição 

t Abre somente para leitura, posicionan 

r Abre para leitura e escrita, posicionando o ponteiro no inicio do arquivo. 

w Abre somente para escrita, posicionando o ponteiro no inicio do arquivo € 
deixando-o com tamanho zero. Se o arquivo não existir, tenta criá-lo. 

wt Abre para leitura e escrita, posicionando o ponteiro no inicio do arquivo e 
deixando-o com tamanho zero. Se o arquivo não existir, tenta criá-lo. 

'a' Abre somente para escrita, posicionando o ponteiro no final do arquivo. Se 
o arquivo não existir, tenta criá-lo. 

tat Abre para leitura e escrita, posicionando o ponteiro no final do arquivo. Se 
o arquivo não existir, tenta criá-lo. 

Se Cria e abre um arquivo somente para escrita, posicionando o ponteiro no 


início do arquivo. Se o arquivo já existir, retoma falso (FALSE) egeraumerro 
do tipo E WARNING. Disponivel desde a versão 4.3.2 do PHP, esse modo 
é usado apenas em arquivos locais. 


ar Cria e abre um arquivo para leitura e escrita, posicionando O ponteiro no 
início do arquivo. Se o arquivo já existir, retorna falso (FALSE) e gera umerro 
do tipo E WARNING. Disponivel desde a versão 4.3.2 do PHP, esse modo 
é usado apenas em arquivos locais. 


Existe ainda a possibilidade de usar as letras ‘b’ ou “? como último caractere do 
parâmetro modo. A letra ‘b força o uso do modo binário, devendo ser utiliza- 
da em sistemas que diferenciam arquivos nos formatos binário e texto. A letra 
w é usada em sistemas Windows para traduzir os caracteres de quebra de linha 
An) para \An. Veja alguns exemplos de uso da função /opem: 


<?php 

Sponteiro = fopen ("/home/juliano/teste. txt", “rd; 
Sponteiro = fopen (“/home/juliano/testeZ, txt”, “wb”); 
ponteiro = fopen (“/home/juliano/testeZ. txt”, “a+"); 


Sponteiro = fopen CChttp://mw.teste.com.br”, “rd; 


?> 


Se você estiver com problemas pata a criação ou abertura de um arquivo, ve- 
rifique se você tem as devidas permissões para acessar O diretório no qual a 
gravação deveria ser feita. Outro detalhe importante diz respeito aos sistemas 
Windows, onde devem ser acrescentados caracteres de escape ao utilizarmos 
as barras invertidas. Por exemplo: 


<?php 


$ponteiro = fopen (“e:\\eeste\\arquivo. txt", “ro; 


?> 
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fclose 


Para fechar um arquivo, utilizamos a função fclose, que possui a seguinte sinta- 
xe: 


bool felose (recurso ponteiro arquivo) 


Essa função retorna true se o arquivo foi fechado com sucesso e retorna false 
se houver alguma falha, O parâmetro passado para a função fciose deve conter 
a variável para a qual foi atribuído o resultado da função fopen, ou seja, o 
ponteiro (handle) para o arquivo que foi aberto. Exemplo: 


<?php 


Sponteiro = fopenQ'arquivo.txt”, Fr); 


fclose($ponteiro); 


?> 
fread 


Uma das formas de ler dados de um arquivo é utilizar a função fread, que 
permite especificar a quantidade de informações a serem lidas. Sua sintaxe é a 
seguinte: 


string fread (recurso ponteiro.arquivo, int tamanho) 


Essa função lê o número de bytes especificado no parâmetro tamanho a partir 
da posição atual do ponteiro definido pelo primeiro parâmetro. A leitura ter- 
mina quando o número de bytes especificado é lido ou o fim do arquivo (FOF 
- End Of File) é alcançado. Por exemplo: 


e leitura php 


<?php 
$ponteiro = fopen ('teste.txt, “rd 
fconteudo = fread CSponteiro, 30); 


echo $conteudo; 


fclose ($ponteiro); 


?> 


Esse programa abre um arquivo chamado teste ext e lê os seus 30 primeiros 
bytes, armazenando-os na variável conteudo. Em seguida, O valor obtido é 
exibido na tela com o comando echo e o arquivo é fechado com fclose. 


fgets 


Também realiza a leitura de um arquivo, mas lê no máximo uma linha. É bas- 
tante utilizado quando queremos trabalhar individualmente com cada linha 
do arquivo. Sua sintaxe é a seguinte: 

string fgets (recurso ponteira arquivo [, int tamanho!) 

A leitura é feita até que seja lido o número de bytes especificados em tamanho, 
ou quando terminar à linha atual do arquivo (caracter Yn), ou quando o arqui- 
vo chegar ao seu final. Se não for especificado o parâmetro tamanho, será 
utilizado o valor padrão, que é 1024 bytes (1k). Como exemplo, considere o 
programa linha. php apresentado a seguir. 

se linha.php 


«<?php 


fpontei ro = fopen (“treste txt”, “py 
$linha = fgets(Sponteiro, 4096); 
echo Slinhas 


fclose CSponteiro); 


F> 


Esse programa lê a primeira linha de um arquivo, exibindo-a na tela, Note que 
foi utilizado um valor bem alto (4096) para garantir a leitura da linha inteira. Se 
a função fgets fosse chamada novamente, seria retornada a segunda linha do 
arquivo, e assim por diante. 


fwrite 


Para escrever dados em um arquivo com o PHP, utilizamos a função fwrite, 
que possui a seguinte sintaxe; 


int fwrite (recurso ponteiro. arquivo, string string [ int tamanhol) 


Esta função escreve o conteúdo do parâmetro string no arquivo referenciado 
pelo parâmetro ponteiro arquivo. O parâmetro tamanho é opcional. Se for 
informado, a escrita irá parar após serem atingidos o número de bytes especi- 
ficado. Veja um exemplo de utilização dessa função: 


&s escrita.php 


<?php 

tconteudo = “Este texto será escrito no arquivol”"; 
Sponteiro = fopen Carquivo.txt”, “wl); 
fwrite($ponteiro, fconteudo); 


fclose (iponteiro); 
?> 
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Esse programa tentará abrir um arquivo chamado arquivo. txt no modo de es- 
crita, eliminando o seu conteúdo e posicionando o ponteiro no início do ar- 
quivo. Caso o arquivo não exista, ele tentará criá-lo. Lembre-se que para isso é 
necessário que o diretório possua permissão de escrita, 


Em seguida, é utilizada a função fwrite para escrever a string armazenada na 
variável $conteudo no arquivo. Por fim, o arquivo é fechado com felose. 


Exemplo: contador de acessos 


Utilizando arquivos você pode criar um contador de acessos para as páginas 
do seu site. Você pode criar um único contador para o site inteiro, ou então 
criar scripts individuais para contar os acessos de cada página, Como exem- 
plo, vamos criar um programa que armazena o valor atual em um arquivo 
chamado contador txt e o incrementa a cada acesso, Esse programa será uma 
include nomeada como contadorinc, que posteriormente poderá será incluí- 
da nas páginas que desejarmos realizar a contagem. Acompanhe o código apre- 
sentado a seguir. 


& contador.inc 


<?php 
Sarquivo = “contador.txt"; // arquivo do contador 
ifCfilecexists(Sarquivo)) // se existe, lê o valor atual e o incrementa 
{f 
$fd = fopen(Sarquivo,"r'D; 
fvalor. atual = chop(fgets($fd)); 
felose($fd); 
$valor atual++; 
+ 
else 
Svalor. atual = 1: 
/! grava o novo valor no arquivo 
Sponteiro = fopen (Sarquivo, "wJ; 
fwrite(Sponteiro, $valor.atual); 
fclose (Sponteiro); 
7> 


A 


Primeiramente, é utilizada a função file exists para testar se o arquivo 
coniador txt já existe. Caso ele exista, obtemos seu valor atual utilizando a fun- 
ção {getse logo após o incrementamos. Note que nesse exemplo utilizamos a 
função chop do PHP no momento da leitura do conteúdo do arquivo. Essa 


função tem por finalidade remover os espaços € quebras de linha existentes 
no fim de uma string. Se não utilizarmos essa função, poderão ocorrer proble- 
mas no momento de realizar operações aritméticas sobre o dado lido. 


Caso o arquivo do contador ainda não tenha sido criado, atribuimos O valor 1 
à variável que armazena o valor atual. Em seguida, o arquivo do contador é 
aberto (ou criado) no modo de escrita e o valor atual é gravado por meio da 
função fwrite, 


Lembre-se que o diretório onde o programa está sendo executado deve pos- 
suir permissão de escrita (isso pode ser configurado no Linux por meio do 
comando chmod. Então, bastaria colocar uma chamada para o contador nas 
páginas que desejarmos: 


include “contador inc”; 


Dessa forma o arquivo contador txt sempre irá armazenar O número total de 
acessos que determinadas páginas tiveram. Uma alternativa seria você usar 
arquivos texto separados para contar de forma individual o número de visitas 
a diferentes páginas do site. 


Outras funções para o sistema de arquivos 


Além das funções principais que acabamos de ver, existem dezenas de fun- 
ções adicionais para o tratamento de arquivos. A seguir são apresentadas as 
funções que podemos utilizar, juntamente com a descrição e sintaxe de cada 
uma delas: 


basename 


Retorna o nome do arquivo que faz parte do caminho (path) fornecido. Permi- 


te especificar um sufixo a ser eliminado caso ele exista no final do nome do 
arquivo, 


string basename (string caminho L, string sufixol) 
chgrp 


Tenta alterar o grupo a que pertence o arquivo. 


bool chgrp (string nome „arquivo, misto grupo) 


chmod 


Tenta alterar as permissões do arquivo, de acordo com O modo fornecido. 


bool chmod (string nome arquivo, int modo) 
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Tenta alterar o proprietário do arquivo, 


bocel chown (string nome arquivo, misto usuário) 


clearstatcache 


Limpa a memória cache que armazena informações de estado do arquivo, O 
PHP utiliza essa memória para melhorar o desempenho na execução de algu- 
mas funções, como stat, Istat, file exists, is. writable etc. 

void clearstatcache (vazio) 


copy 
Copia um arquivo, 
boo] copy (string origem, string destino) 

delete 
Exclui um arquivo, assim como a função unlink, 
void delete (string arquivo) 

dirname 
Retorna o diretório que faz parte do caminho (path) fornecido, 
string dirname (string caminho) 

disk free space 
Retorna o espaço (em bytes) disponível no diretório. 
float disk.free.space (string diretório) 

disk total space 
Retorna o tamanho (em bytes) total de um diretório. 
float disk total. space (string diretório) 


diskfreespace 
É um apelido (alias) para a função disk free.space. 
fclose 


Fecha um arquivo, 


boo] fclose (recurso ponteiro arquivo 
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feof 
Testa se o ponteiro já alcançou O final do arquivo. 
bool feof (recurso ponteiro arquivo) 

fflush 


Força a escrita de todos os dados de saída armazenados em buffer para um 
arquivo. 


bool fflush (recurso ponte iro arquivo) 
fgete 
Obtém um caractere a partir da posição atual do ponteiro do arquivo. 
string fgerc (recurso ponteiro arquivo) 
fgetosv 
Lé uma linha do arquivo e analisa os campos como se estivessem no formato 
CSV, 


array fgetesv (recurso ponteira.arquivo, int tamanho [, string 
delimitador [, string delimitadorD) 


fgets 

Lê uma linha do arquivo. 

string fgets (recurso ponteiro arquivo L, int tamanho!) 
fgetss 


Lê uma linha do arquivo e retira as tags HTML e PHP. 


string fgetss (recurso ponteiro arquivo, int tamanho [, string 
tags. permitidas!) 


file exists 
Testa se um arquivo ou diretório existe. 
bool file exists (string nome arquivo) 
file get contents 


Lê o conteúdo inteiro de um arquivo, retornando-o em uma string. 


string file get. contents (string nome. arquivo {, int usar include. path 
[, recurso contextol]) 
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file put contents 
Escreve uma string em um arquivo. É equivalente a chamar as funções fopen, 
fwrite e fclose sucessivamente. 


int File put.contents (string nome arquivo, string dados [, int flags 
É, recurso contextol) 


file 


Lê o conteúdo inteiro de um arquivo, retornando-o em array onde cada ele- 
mento corresponde a uma linha do arquivo. 


array file (string nome.arquivo [, int usar. include. path [, recurso 
contexto]!) 


fileatime 


Retorna a hora do último acesso ao arquivo, utilizando formato timestamp do 
UNIX, 


int fileatime (string nome arquivo) 
filectime 


Retorna a hora da última modificação no descritor do arquivo, utilizando for- 
mato timestamp do UNIX. 


int filectime (string nome arguivo) 
filegroup 
Retorna o identificador do grupo ao qual pertence o arquivo, 
int filegroup (string nome arquivo) 
fileinode 
Retorna o descritor Cinode) do arquivo. 
int fileinode (string nome arquivo 


filemtime 


Retorna a hora de alteração do arquivo, utilizando formato timestamp do UNIX. 
int filemtime (string nome arguivo) 


fileowner 


Retorna o número identificador do proprietário do arquivo, 


int fileonner (string nome.arquivo) 


ERR 


iscas 
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fileperms 


Retorna as permissões de acesso do arquivo. 


int fileperms (string nome arquivo) 
filesize 


Retorna o tamanho do arquivo, em bytes. 


int filesize (string nome arquivo) 
filetype 
Retorna o tipo do arquivo. Os valores possiveis são fito, chat, dir, block, link, 
file e unknown. 
string filetype (string nome arquivo) 
flock 
Bloqueia ou desbloqueia um arquivo para realizar determinadas operações. 
Pode ser udado, por exemplo, para evitar escritas concorrentes, 
bool flock (recurso ponteiro arquivo, int operação [, int &bloquear]) 


fnmatch 


Busca por um padrão em um nome de arquivo. 


array fnmatch (string padrão, string string L, int flags)) 


fopen 


Abre um arquivo ou URL. Os modos de abertura mais usados são “r” (leitura), 
“r+” (leitura e escrita), “w” (escrita, zerando o arquivo), “w+” (leitura e escrita, 
zerando o arquivo), “a” (escrita, posicionando no final do arquivo) e “a+” dei- 
tura e escrita, posicionando no final do arquivo). 


recurso fopen (string some. arquivo, string modo É, int 
usar. include. path l, recurso contextol)) 


fpassthru 


Exibe os dados restantes a partir da posição atual do ponteiro do arquivo. 
int fpassthru (recurso ponteira.arquivo) 


fputs 


É um apelido (alias) para a função Arite, 
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Lê dados de um arquivo, A leitura termina quando o número de bytes especifi- 
cado é lido ou o fim do arquivo é alcançado, 
string fread (recurso ponteiro.arquivo, int tamanho) 


fscanf 
Interpreta o conteúdo de um arquivo de acordo com um determinado forma- 
to, 
misto fscanf (recurso ponteiro. arquivo, string formato [, string vari]) 


fseek 


Posiciona o ponteiro em um arquivo. À nova posição é obtida adicionando-se 
o parâmetro ofiserà posição especificada pelo parâmetro focal, que pode as- 
sumir os valores SEEK. SET (padrão), SEEK CURe SEEK END. 


int fseek (recurso ponteiro.arquivo, int offset [, int Jocall) 
fstat 

Retorna informações sobre um arquivo usando um ponteiro aberto, 

array fstar (recurso ponteiro arquivo) 


ftell 


Retorna a posição atual de leitura/escrita do ponteiro do arquivo. 


int frell (recurso ponteiro. arquivo) 


ftruncate 


Trunca um arquivo, ou seja, elimina seu conteúdo deixando-o com tamanho 
Zero. 


bool ftruncate (recurso ponteiro arquivo, int tamanho) 


fwrite 


Escreve dados em um arquivo. Se for informado o parâmetro tamanho, a escri- 
ta irá parar após serem atingidos o número de bytes especificado. 


int fwrite (recurso ponteiro.arquivo, string string [, int tamanho]) 
giob 

Retorna um array contendo todos os caminhos (arquivos/diretórios) que satis- 

fazem um determinado padrão. 


array glob (string padrão [, int Flags]) 


| 
| 
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É imieniesmnimam cao me a e RÉ da dE 


| is dir 
| Testa se o nome fornecido é um diretório, 
bool is.dir (string nome arquivo) 
is executable 


Testa se um arquivo é executável. 


bool is executable (string nome.arquivo) 
is file 
Testa se o nome fornecido é um arquivo válido. 
bool is. file (string nome arquivo) 
is link 
Testa se o arquivo é um link simbólico. 
bool is link (string nome arquivo) 


is readable 


Testa se o arquivo pode ser lido. 


bool is. readable (string nome arquivo) 
is uploaded file 


Indica se o arquivo foi enviado através de um upload via HTTP pelo método 
POST. 
bool is uploaded. file (string rome arquivo) 


is writable 


Testa se o arquivo pode ser escrito. 


bool is „writable (string nome arquivo) 
is_writeable 

Apelido (a/ias) para a função is. writable. 
link 

Cria um link fisico. 

bool Tink (string alvo, string 772W 
linkinfo 


Retorna informações sobre um link. 


int linkinfo (string caminho) 
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Istat 
Retorna informações sobre um arquivo ou um link simbólico, 
array Istat (string some arquivo) 

mkdir 


Cria um diretório, 


bool mkdir (string caminho [, int modol) 


move_uploaded_file 
Move um arquivo enviado por upload para um novo local, 
boo! move. uploaded. file (string nome arquivo, string destino) 
parse ini file 
Analisa um arquivo de configuração ini, retornando suas informações em um 
array associativo, 
array parse ini file (string nome arquivo [, bool seções. processos]) 
pathinfo 
Retorna um array associativo contendo informações sobre o caminho para um 


arquivo, Os elementos retornados são dirname, basename e extension. 
array pathinfo (string caminho) 


pelose 
Fecha o ponteiro para um processo, aberto com popen. 
int pclose (recurso ponteiro arquivo) 
popen 
Abre um ponteiro para um processo. Difere do fopen por ser unidirecional 


(usado somente para leitura ou para escrita). O ponteiro pode ser utilizado em 
funções como fgets, fgetss e fpuls. 


recurso popen (string comando, string modo) 
readfile 


Lê um arquivo e imprime seu conteúdo na saída-padrão. 


int readfile (string nome arquivo [, bool usar. include path [, recurso 
contextoll) 


readlink 


Retorna o destino de um link simbólico. 
string readiink (string caminho) 


realpath 


Retorna um caminho em sua forma canônica, expandindo links simbólicos e 
resolvendo referências como '// e LA. 
string realpath (string caminho) 
rename 
Renomeia um arquivo. 
bool rename (string nome antigo, string novo. nome) 
rewind 
Retorna o ponteiro ao início do arquivo. 
bool rewind (recurso ponteiro arquivo) 
rmdir 
Exclui um diretório. 
bool rmdir (string diretório) 
set_file_buffer 
Apelido (altas) para a função stream set. Wre.. buffer. Permite ajustar a quanti- 


dade de dados a serem armazenados em buffer nas operações de escrita. 


int stream set write buffer (rescurso arquivo, int buffer) 


stat 


Retorna um array contendo informações sobre um arquivo, como número do 
descritor Unode), identificador do proprietário, tamanho, último acesso, entre 
outras. 


array stat (string nome arquivo) 
symiink 

Cria um link simbólico. 

bool symlink (string alvo, string Zink) 
tempnam 


Cria um nome de arquivo único dentro do diretório especificado. 


string tempnam (string dir, string prefixo) 
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tmpfile 


Cria um arquivo temporário com um nome único, no modo de escrita. O ar- 
quivo é automaticamente excluído ao final da execução ou se ele for fechado 
de forma explícita com fclose., 


recurso tmpfile (vazio) 


touch 


Tenta configurar a hora de acesso e de modificação de um determinado arqui- 
vo. 


bool touch (string nome.arquivo [, int tempo [, int tempo acesso]]) 


umask 


Troca a máscara (umask) corrente e retorna a máscara antiga. 


int umask CLint mask]) 
unlink 


Exclui um arquivo, Retorna TRUE em caso de sucesso e FALSE se falhar, 


bool unlink (string nome arquivo) 


Capítulo 15 


Enviando e-mails com o PHP 


O envio de e-mails com o PHP é um recurso utilizado com frequência pelos 
desenvolvedores de páginas Web. Neste capítulo veremos qual é a utilidade 
de enviar e-mails por meio de seus programas e como utilizar a função que 
executa essa tarefa. 


Por que enviar e-mails com o PHP? 


Existem diversas situações em que o envio de e-mails pelo PHP é de grande 
utilidade. Quando, por exemplo, um usuário preenche o formulário de cadas- 
tramento de um site, escolhendo um username (nome de usuário) e uma se- 
nha, é comum que o sistema lhe envie automaticamente um e-mail confirman- 
do seu cadastro, enviando também os dados que ele forneceu por meio do 
formulário, Isso é feito para que o usuário possa guardar essas informações, 
podendo recuperá-las em caso de esquecimento da senha ou do username. 


Outro exemplo que pode ser citado é o de uma loja que vende os seus produ- 
tos pela Internet, e cada pedido de compra é armazenado no banco de dados, 
Como a loja vai saber se algum cliente realizou alguma compra? Uma alterna- 
tiva seria fazer um programa que consulte o banco de dados e mostre os pedi- 
dos ocorridos em determinado período de tempo. Mas nesse caso a melhor 
alternativa seria fazer com que a loja recebesse um e-mail informando que 
houve uma compra. Esse e-mail poderia conter, por exemplo, nome e endere- 
ço do cliente e os produtos que ele comprou. 


Seria interessante que o cliente também recebesse um e-mail informando que 
seu pedido foi recebido, com outras instruções que ele deve seguir para rece- 
ber os produtos comprados. Nesse caso o programa PHP que recebe os dados 
do cliente e da compra deveria realizar três tarefas: 


5 Gravar os dados do cliente e da compra no banco de dados. 
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2) Enviar um e-mail para o cliente confirmando o recebimento de seu pedido. 


3) Enviar um e-mail para a própria loja, notificando-a de que houve uma com- 
pra, para que o pedido seja processado. 


Alguns desenvolvedores, para garantir que o usuário digite o e-mail correto 
no momento do cadastro, utilizam o PHP para enviar um e-mail para o endere- 
ço digitado, enviando nesse e-mail uma senha especial. Então, o usuário deve 
acessar uma outra página e digitar essa senha para validar seu cadastro, 


Outra situação que pode ser citada é o envio de sugestões ou comentários 
pelos usuários de um site. Muitos sites apresentam um formulário pelo qual o 
usuário pode enviar suas opiniões. No momento em que o usuário termina de 
digitar e clica no botão “Enviar”, o programa PHP que recebe os dados envia 
dois e-mails: um para o próprio site, contendo os dados do formulário, e outro 
para o usuário, agradecendo e confirmando o recebimento de sua opinião, 


Enfim, essas são apenas algumas das inúmeras aplicações desse recurso que o 
PHP nos oferece, 


Utilizando a função mail 


f 


A função mail é a única responsável pelo envio de e-mails por meio de progra- 
mas PHP. Sua sintaxe é a seguinte: 


boo! mail (string destinatário, string assunto, string mensagem L, 
string cabeçalhos. adicionais [, string parámetros adicionais] 


Esta função envia automaticamente um e-mail para o endereço especificado 
em destinatário, contendo o texto especificado em mensagem. O título do e- 
mail deve ser especificado no parâmetro assunto, As informações mostradas 
entre colchetes são opcionais, 


Veja um simples exemplo de uso da função maif 
maill" joaofdominio.com, br”, “Bem-vindo”, “olá Jodoinseja bem-vindo!"3; 


Podemos também enviar um e-mail para múltiplos destinatários. Para isso, basta 
separar os endereços pelo caractere ; (ponto-e-vírgula), conforme mostra o 
exemplo a seguir: 


mai tC'joaofidominio, com.br; pedrofoutrodominio. com.br”, “Teste”, “Olá João e 
Pedrolínisto é um teste”); 


O caractere especial An representa uma quebra de linha. É o equivalente a 
apertar a tecla ENTER nos editores de texto, Portanto, quando esse comando 
for executado, será enviado um e-mail com o título “Teste” para os dois ende- 
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reços especificados no primeiro parâmetro da função, e esse e-mail conterá a 


seguinte mensagem: 


otá João e Pedro! 


Isto é um teste 


Como exemplo, veremos um programa que recebe sugestões enviadas por 
visitantes de um site e as envia por e-mail ao webmaster, Esse programa será 
ativado por um formulário HTML, onde o usuário vai digitar seu nome, e-mail 
e sua sugestão. O código para esse formulário será o seguinte: 


eee meto nene 


& exemplo15. 1.html 


<HTML> 

<BODY> 

<form actions"exemplol5. 1.php” method=" POST" > 
Nome: <input type="text” name=" nome" ><br> 
E-mail: <input type="text” name=" emai ]"><br> 
sugestão: <input type="text” name=" sugestao”><br> 
<input type="submit” names“enviar” values"enviar!”> 

</form> 

</BODY> 

</HTML> 


Ao acessar essa página em seu navegador, você verá a seguinte tela. 


Figura 15.1 — Formulário para o envio de sugestões. 


Quando o usuário clicar no botão “Enviar!”, os dados serão submetidos ao 
programa exemplo Is. Lohp, apresentado a seguir. Esse programa obtém os 
dados que o usuário digitou e coloca-os em forma de uma mensagem, para 
depois enviá-los utilizando a função mail 


i 


& exemplo15 1.php 


<?php 
Snome = $.PosT[“nome"]; 
$email = $S.posTICemail"]: 
isugestao = $ POsT[" sugestao”); 


$mensagem = “Sugestão enviada por um visitante: \nn"; 


$mensagem .= “Nome: $nomein”:; 
$mensagem = “E-mail: $email\n”; 
$mensagem .= “Sugestão: $sugestao”; 


mailCwebmasterQumsite. com.br”, “Sugestao”, $mensagem); 


echo “obrigado por enviar sua sugestão!”: 
?> 


Note que foi utilizado o operador de concatenação (.) para formar a mensa- 
gem que foi enviada pela função mail 


Configurações no arquivo php.ini 


O arquivo de configuração php.ini possui algumas diretivas de configuração 
que estão relacionadas com o envio de e-mails pelo PHP, A seguir são apre- 
sentadas essas diretivas, juntamente com uma descrição de cada uma delas, 


Diretiva Descrição 

SMTP Contém o nome ou o IP do servidor SMTP que o PHP deve utilizar para 
enviar e-mails com a função mail no Windows (default=locaihost. 

smtp. port Disponivel desde o PHP 4.3.0, contém o número da porta na qual deve 


ser feita a conexão com o servidor especificado na diretiva SMTP 
(default=porta 25). Utilizada somente no Windows, 


sendmail from Endereço de e-mail que deve ser usado no campo do remetente 
(From: nos e-mails enviados pelo PHP no Windows (defaultz NULL). 
sendmail. path Indica onde o programa do sendmail pode ser encontrado no sistema, 


Normalmente contém o valor /usr/sbin/sendmail ou Ausr/lib/sendmail. 
Para sistemas que não utilizam o sendmail, essa diretiva deve ser 
configurada de acordo com o software utilizado. Por exemplo, usuários 
do Qmail podem alterar essa diretiva para Aar/gmailbin/sendmail ou / 
var/amaibbin/igmail-inject. 


Adicionando informações ao cabeçalho do e-mail 


A função mai/ainda possui um quarto e um quinto parâmetro, que são opcio- 
nais, Se o quarto parâmetro for passado, ele será acrescentado ao final do ca- 


| 


IC 


sa 


| 


: 


beçalho do e-mail, Esse parâmetro é utilizado para enviar informações extras 
ao servidor que receberá a mensagem. Nele podemos incluir uma ou mais 
informações extras, separando-as por uma quebra de linha (caractere Am). Veja. 
um exemplo simples: 


g exemplo15 .2.php 


<?php 
ide = “webmasterQalgumdominio.com.br”; 
$para = “alguemêdominia.com.br”; 
$mensagem .= “Isto é um teste!” 
mail(Spara, “Teste”, $mensagem, “erom: $de"); 


?> 


Esse comando envia, no quarto parâmetro, à informação From, que indica, ao 
servidor que receberá a mensagem, qual o endereço eletrônico do remetente. 
Agora observe o comando a seguir, que envia mais de uma informação no 
quarto parâmetro da função maik 


mailCalguemêdominio, com”, “Teste”, $mensagem, "From: 
webmaster@dominio.comnReply-To: info@dominio. com”); 


A informação Reply-To indica para qual endereço eletrônico deve ser enviada 
a resposta para este e-mail, Portanto, quando o destinatário receber o e-mail 
em seu programa de correio eletrônico, ao clicar em “Responder”, nem sem- 
pre a resposta será enviada para o remetente da mensagem. A resposta será 
enviada para o endereço especificado na opção Reply-To. Veremos no final 
deste capítulo outras informações extras que podemos enviar, 


Apenas para seu conhecimento, existe ainda um quinto parâmetro da função 
mail, pelo qual podemos enviar informações extras à chamada do programa 
que envia os e-mails. Essas informações são as mesmas que poderíamos passar 
se o programa fosse chamado pela linha de comando do sistema operacional, 


Enviando e-mails em formato HTML 


O envio de e-mails em formato HTML está sendo cada vez mais utilizado por 
diversos sites que necessitam dos recursos de correio eletrônico. Em vez de 
enviar um e-mail em formato texto, sem cores, figuras ou qualquer outra for- 
matação, OS desenvolvedores estão optando por enviar e-mails com todos os 
recursos que o HTML nos oferece. 


Muitos sites costumam enviar um clipping (informativo sobre as novidades da 
semana, por exemplo) aos seus usuários, Com certeza será muito mais atrativo 
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se os usuários receberem um e-mail colorido e com imagens que receber um 
e-mail com texto puro. Provavelmente muitos deles nem sequer leriam um e- 
mail que possuísse uma enorme quantidade de texto sem formatação nenhuma. 


No entanto, o formato texto é o padrão para o envio de e-mails por meio da 
função mail do PHP, Se tentarmos simplesmente colocar tags HTML em uma 
mensagem e enviá-la a algum e-mail, essas tags não serão reconhecidas pelo 
gerenciador de e-mails do destinatário. Veja o seguinte exemplo: 


sa exemplo15 3.php 


<?php 
$mensagem = “<font color="80000FFN">Teste</font>"; 


maiiC'joaoQdominio.com.br”, “Teste”, $mensagem); 
F> 


O objetivo seria enviar um e-mail escrito “Teste” em letras azuis, porém o dono 
do endereço joaofBdominio.com.br receberá um e-mail escrito: 


<font color="40000FE">Teste</font> 


Portanto para enviar e-mails em formato HTML não basta simplesmente colo- 
car as tags. Além de colocá-las na mensagem, devemos informar o tipo de e- 
mail que está sendo enviado, Isso é feito por meio do quarto parâmetro da 
função mail, com o uso da opção Content-Type. Essa opção deve conter O 
valor text/html quando quisermos enviar e-mails em formato HTML. 


Veja o exemplo: 


g exemplo15. 4.php 


<?php 
$para = “joaofidominio.com,br”; 
$mensagem = “<font colors E0000FFV >Teste</font>"; 


maiiCSpara, “Teste”, $mensagem, “Content-Type: text/html"); 
?> 


Por meio do quarto parâmetro da função mail foi enviada uma informação 
extra (Content-Type) informando que este e-mail contém texto e tags HTML. 
Quando o destinatário receber este e-mail, essa informação será analisada por 
seu gerenciador, que fará a leitura adequada. 


Para evitar a tarefa de ter de digitar os comandos HTML, é possível a utilização 
de um editor de páginas, como, por exemplo, o FrontPage ou o Dreamweaver. 
Após construir a página, basta copiar O código HTML que o editor gerou € 
trazê-lo para o programa PHP, atribuindo-o para a variável que deverá conter 
o conteúdo do e-mail a ser enviado. 
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É importante lembrar que nem todos os programas gerenciadores de e-mails 
leem em formato HTML. Muitas pessoas podem utilizar um gerenciador que 
só lê em formato-texto, e dessa forma elas verão o texto em códigos, mesmo 
que a opção Content-Type contenha o valor text/html. 


Seesen ovana 


“Lista dos cabeçalhos de e-mail (mail headers) 


Veremos agora uma lista das informações extras que podem ser enviadas em 
um e-mail, Essas informações são conhecidas como mail headers (cabeçalhos 
de e-mail). Logo sem seguida temos a descrição das principais delas: 


e Bec: é uma abreviatura para Blind Carbon Copy. É utilizado para enviar 
cópias da mensagem para outros endereços, sem que os destinatários co- 
nheçam os endereços para quais a mensagem foi enviada. Quando utiliza- 
do, o Bec não aparece no cabeçalho do e-mail recebido pelo destinatário. 


e Ce: é uma abreviatura para Carbon Copy, e serve para especificarmos des- 
tinatários adicionais. A diferença entre To e Cc é apenas conotativa, pois 
alguns programas tratam essas informações de maneiras diferentes no mo- 
mento de enviar respostas, 


« Comments: normalmente este header é adicionado por alguns programas 
para especificar quem enviou a mensagem. Algumas vezes os spammers 
(aqueles que enviam e-mails não solicitados) o adicionam manualmente 
com informações falsas. 


* Content-Transfer-Encoding: é um header relacionado com MIME (Multi- 
purpose Internet Mail Extentions). Define como o conteúdo da mensagem 
deve ser interpretado. Normalmente é utilizado para conteúdos que não 
são do tipo texto, 


* Content-Type: outro header relacionado com MIME. Informa como o pro- 
grama de e-mails deve tratar a mensagem. Veja alguns tipos de MIME que 
são aceitos: 


text/plain documento em formato texo (ASCID. 
text/html documento em HTML. 
application/postscript documento PostScript, 
image/gif imagem codificada em formato GIF. 


image/jpeg: imagem codificada em formato JPEG. 


Desenvolvendo Websites com PHP 


audio/basic um arquivo de som, 
video/mpeg. um vídeo codificado em mpeg. 
x-worid/x-vrim; arquivo do tipo VRML, 


Date: especifica a data em que a mensagem foi enviada, Alguns computa- 
dores podem ter seu relógio desconfigurado, portanto nem sempre pode- 
mos garantir que essa informação seja correta. 


Errors-To; especifica um endereço para que sejam informados os erros no 
envio da mensagem, 


From: contém o endereço do remetente da mensagem, 


Message-Id: é um identificador atribuído a uma mensagem. E-mails em que 
esta informação é vazia provavelmente foram forjados. 


Mime-Version: especifica a versão do protocolo MIME que está sendo uti- 
lizada pelo programa de e-mails, 


Priority: atribui uma prioridade a um e-mail. Alguns spammers enviam e- 
mails com prioridade “Urgente”, para tentar fazer com que seus e-mails 
sejam lidos, Muitos programas gerenciadores de e-mails não lêem este tipo 
de header. 


Received: fornece um log detalhado do histórico da mensagem, tornando 
possível o conhecimento de sua origem. 


Reply-To: especifica o endereço para o qual a mensagem deve ser respon- 


` dida, Quando a pessoa clicar em “Responder” em seu gerenciador de e- 


mails, a resposta será enviada para o e-mail especificado nesse header, 


Sender: este header é pouco comum em um e-mail. Normalmente X-Sen- 
der é utilizado em seu lugar para especificar que está enviando a mensa- 
gem. O Sender é um header mais confiável que o From. 


Subject: contém o título da mensagem. 
To: contém o endereço do(s) destinatário(s) da mensagem. 


X-Confirm-Reading-To: este header solicita uma confirmação de recebi- 
mento por parte do destinatário do e-mail, porém ele pode enviar ou não 
essa confirmação. 


X-Mailer: identifica o software que enviou o e-mail, 


Apêndice A 


Comandos gerais do PHP 


Neste apêndice veremos uma rápida descrição de cada um dos principais co- 
mandos do PHP. Não serão mostrados todos os comandos da linguagem, mas 
veremos principalmente aqueles que estão relacionados com os conteúdos 


apresentados neste livro. 


Os comandos foram divididos em diversas categorias, como: arrays, strings, 
variáveis, funções, classes e objetos, matemática, data e hora, sistema de arqui- 
vos (filesystem), diretórios, HTTP, FTP, URL, imagens, opções e informações 


do PHP e sessões. 


Arrays 


array change key case 
array. chunk 


array. count values 
array. diff assoc 


array. diff 

array. fl 

array. fiter 

array. fip 

array, intersect 

array. intersect assoc 


array, key exists 


Descrição 


Cria um array. 


Retoma um array com todas as chaves em letras maiúsculas 
ou minúsculas. 


Divide um array em diversos arrays com um determinado 
tamanho. 


Conta todos os valores de um array. 


Retorna os valores do primeiro array que não existem nos 
demais arrays fornecidos. As chaves (indices) também são 
utilizadas na comparação. 


Calcula a diferença entre arrays. 

Preenche um array com um determinado valor. 

Filtra elementos do array utilizando uma função de callback. 
Retorna um array com chaves e valores trocados. 

Calcula a intersecção entre arrays. 


Calcula a intersecção entre arrays, comparando também as 
chaves dos elementos. 


Verifica se uma deferminada chave existe em um array. 


array. keys 
array map 
array merge 


array merge. recursive 


array multisort 
array. pad 
array. pop 
array push 
array sand 
array, reverse 
array. reduce 
array. shift 
array_slice 
array splice 
array sum 
array unique 
array unshift 
array values 
array walk 
arsort 

asort 
compact 
count 

current 

each 

end 

extract 

in array 
array. search 


key 

krsort 

ksort 

list 

naisort 
natcasesort 


next 
pos 
prev 
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Descrição (cont.) 

Retorna todas as chaves de um array. 

Aplica o callback sobre os elementos dos arrays dados, 
Une dois cu mais arrays. 

Une dois ou mais arrays recursivamente. 

Ordena arrays multidimensionais, 

Preenche determinado tamanho de um array. 

Retira um elemento do fim do array. 

insere um elemento no fim do array. 

Retorna chaves para entradas randômicas de um array. 
Retorna um array com seus elementos em ordem reversa, 
Reduz um array a um valor simples. 

Retira um elemento do início do array. 

Retorna uma parte do array. 

Substitui uma parte de um array. 

Soma os elementos de um array. 

Remove valores duplicados de um array. 

Coloca um ou mais elementos no início do array, 

Retorna todos os valores de um array, 

Aplica determinada função sobre cada elemento do array. 
Ordena um array em ordem reversa. 

Ordena um array. 

Cria um array contendo variáveis e seus valores. 

Conta o número de elementos em uma variável ou array. 
Retorna o elemento corrente de um array. 

Retorna o próximo par chave/valor de um array. 

Aponta o ponteiro interno do array para seu último elemento. 
importa variáveis de um array para a tabela de simbolos. 
Retorna TRUE se determinado valor existe no array. 


Procura um valor dado em um array e retorna sua chave em 
caso de sucesso, 


Busca uma chave de um array associativo. 

Ordena um array por chave em ordem reversa. 
Ordena um array por chave, 

Atribui valores de um arrays a variáveis especificadas. 
Ordena um array usando o algoritmo “natural order”. 


Ordena um array usando o algoritmo “natural order” não 
diferenciando letras maiúsculas e minúsculas. 


Avança o ponteiro inferno de um array. 
Obtém o elemento corrente de um array. 
Retrocede o ponteiro interno de um array. 


sizeof 
sort 
uasort 


uksort 


usort 


Classes e objetos 


call user method 
class exists 

get class 

get class methods 
gel class vars 

get declared classes 
get object vars 

get parent class 

is subciass of 


method exists 


Data e hora 


Fun 


date 

getdate 
getimeofday 
gmdate 
gmmktime 


Coloca o ponteiro interno do array em seu primeiro elemento. 
Ordena um array em ordem reversa. 

Embaralha um array trocando a ordem de seus elementos de 
forma aleatória. 

Obtém o número de elementos de um array. 

Ordena um array. 

Ordena umi array com uma função definida pelo usuário e 
mantêm a indexação. 

Ordena um array pelas chaves com uma função definida pelo 
usuário. 

Ordena um array por valores com uma função definida pelo 
usuário. 


Descrição 


Chama um método do usuário com um array de parâmetros. 
Chama um método do usuário em um objeto específico. 
Testa se a classe foi definida. 

Retorna o nome da classe de um objeto. 

Retorna um array com o nome dos métodos da classe. 
Retorna um array com as propriedades-padrão da classe. 
Retorna um array com o nome das classes definidas. 
Retorna um array associativo das propriedades do objeto. 
Retorna o nome da classe-pai (parent) de um objeto. 


Determina se um objeto pertence a uma subclasse da classe 
especificada. 


Testa se um método existe em uma classe. 


- Descrição 
Valida uma data/hora. 


Formata uma data/hora. 

Retorna informações sobre data/hora. 

Retorna a hora atual. 

Formata uma data/hora GMT/CUT, 

Obtém uma data/hora GMT no formato UNIX timestamp. 


gmstritime 


localtime 
microtime 
mktime 
strftime 
time 
strtotime 


Diretórios 


FTP 


chroot 
chdir 

dir 
closedir 
getcwd 
opendir 
readdir 
rewinddir 
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Descrição (cont) E EE 


Formata uma data/hora GMTICUT conforme as configurações 
locais. 


Obtém a hora local. 

Retorna o UNIX timestamp corrente em microssegundos. 
Obtém o UNIX timestamp a partir de uma data. 

Formata uma data/hora local conforme as configurações locais. 
Retorna a data atual no formato UNIX timestamp. 

Tenta traduzir uma string para o formato UNIX timestamp, 


Descrição 

Altera o diretório do root. 

Altera o diretório corrente, 

Classe diretório. 

Fecha o handie do diretório. 

Obtém o diretório corrente de trabalho. 

Abre um handle de diretório. 

Lê uma entrada a partir do handle do diretório. 
Retrocede o handle do diretório. 


Descrição 


ftp chdir 
ftp chmod 
ftp close 
ftp connect 
ftp delete 
ftp. exec 

ftp get 


tp fput 
ftp. get option 


ftp get 

ftp login 
ftp.mdtm 
ftp mkdir 


Altera o diretório em um servidor FTP, 

Define as permissões de um arquivo via FTP, 

Fecha uma conexão FTP, 

Abre uma conexão FTP, 

Exclui arquivos em um servidor FTP, 

Solicita a executação de um programa no servidor FTP, 


Faz o download de um arquivo do servidor FTP e salva em um 
arquivo aberto, 


Envia de um arquivo aberto para um servidor FTP, 


Retorna diversas configurações em tempo de execução da 
conexão FTP corrente, 


Faz o download de um arquivo do servidor FTP, 
Realiza o login em uma conexão FTP. 


Retorna ahora da última modificação de determinado arquivo. 
Cria um diretório. 


ias a ii 


Função Descrição (cont) 0 
Rp nb continue Continua enviando ou recebendo umargquivo (não-bloqueante). 
ftp nb get Retoma um arquivo de um servidor FTP e o grava em um 
arquivo aberto (não-bloqueante). 
tip. nb fput Armazena um arquivo aberto em um servidor FTP (não- 
bloqueante). 
ftp nb get Retorna um arquivo de um servidor FTP e o grava em um 
arquivo local (não-bloqueante). 
ftp nb.put Armazena um arquivo no servidor FTP (não-bloqueante). 
ftp. nlist Retorna uma lista dos arquivos em determinado diretório. 
ftp. pasv Ativa ou desativa o modo passivo. 
ftp. put Envia (upload) um arquivo para um servidor FTP. 
ftp pwd Retoma o nome do diretório corrente. 
ftp. quit Fecha uma conexão FTP. 
ip saw Envia um comando arbitrário para um servidor FTP. 
ftp rawiist Retorna uma lista detalhada dos arquivos em determinado 
diretório. 
ftp. rename Renomeia arquivos em um servidor FTP. 
ftp. rmdir Remove um diretório. 
ftp set option Define diversas opções do FTP em tempo de execução. 
ftp. site Envia um comando do tipo SITE ao servidor. 
ftp size Retorna o tamanho de determinado arquivo. 
ftp ss connect Abre uma conexão segura SSL-FTP. 
ftp systype Retorna o identificador do tipo de sistema do servidor remoto 
de FTP, 
Funções 
Função — Descrição 
call user func “array Chama uma função doi usuário passando um array de 
parâmetros. 
call user func Chama uma função do usuário passando o primeiro parâmetro. 
create function Cria uma função anônima (estilo lambda). 
func get aro - Retoma um item da lista de argumentos. 
func get.args Retorna um array contendo a lista de argumentos da função. 
func num args Retorna o número de argumentos passados para uma função. 
function, exists Testa se uma função foi definida. 
get defined, functions Retoma um array contendo a lista de todas as funções definidas. 


register shutdown function Registra uma função para ser executada ao término do script. 


Desenvolvendo Websites com PHP 


Função Descrição 
header Envia um cabeçalho HTTP, 
headers sent Testa se os headers já foram enviados. 
setcookie Envia um cookie, 
Imagens 
Função Descrição 


as pars E 


exif read data l 
exif thumbnail 


gd into 


image. type. to. mime. type 


image2Zwbmp 


GetimageSize 
imageAlphaBlending 
imageÃro 

mageFilledAro 
mageEllipse 
mageFilledEllipse 
imageChar 

mageCharUp 
mageColorAliocate 
imageColorAliocateAlpha 


mageColorDeAliocate 
mageColorÃt 
mageColorCiosest 
imageColorClosestálpha 


mageColorClosestHWE 


imageColorkxact 


Determina o tipo de uma imagem através da leitura de seus 
primeiros bytes. 
Lê os cabeçalhos EXIF de arquivos do tipo JPEG ou TIFF, 


Retorna a miniatura (thumbnail) embutida em uma imagem 
TIFF ou JPEG. 


Retorna informações sobre a biblioteca GD atualmente 
instalada. 


Obtém o tipo MIME de um tipo de imagem retornado pelas 
funções getimagesize, exif read data, exif thumbnail e 
exif imagetype, 


Envia uma imagem do tipo WBMP para o browser ou para um 
arquivo. 

Retorna o tamanho de uma imagem GIF, JPEG, PNG ou SWF, 
Define o modo de transparência de uma imagem. 

Desenha uma elipse parcial, 

Desenha uma elipse parcial preenchida. 

Desenha uma elipse. 

Desenha uma elipse preenchida, 

Desenha um caractere horizontalmente, 

Desenha um caractere verticalmente. 

Aloca uma cor para uma imagem. 


Aloca uma cor para uma imagem. É semelhante à função 
imageCollorAllocate, possuindo um parâmetro adicional para 
definir a transparência. 


Desaloca uma cor para uma imagem. 
Retorna o indice da cor de um pixel. 
Retorna o indice da cor mais próxima à especificada. 


Obtém o indice da cor mais próxima à cor especificada, 
considerando o parâmetro de transparência, 

Obtém o Índice da cor que possui o tom, branco e preto mais 
próximo da cor especificada. 

Retorna o Índice de uma cor especificada, 


à] 
] 


Função 
ImageColorExactaipha 
imageColorResolve 
imageColorResolveAlpha 


imageGammaCorrect 
imageColorSet 
tmageColorsForindex 
imageColorsTotal 
ImageColor Transparent 
imageCopy 
imageCopyMerge 
imageCopyMergeGray 
imageCopyResized 
imageCopyResampled 
mageCreate 
mageCreateTtueColor 
mageTrueColorToPaletto 
mageCreateFromGD2 


mageCreateFromGD2part 


mageCreateFromGD 


mageCreateFromGIF 
imageCreateFromJPEG 
imageCreatePromPNG 
ImageCreateFromWBMP 
imageCreateFromString 
imageCreateFromXBM 
ImageCreateFromAPM 


imageDashedLine 
imageDestroy 
imagekllipse 
imageFill 


Retorna o índice de uma cor especifi icada + +a alpha. 


Descrição (cont.) .) o 

Retorna o indice de uma cor ou sua alternativa mais pròxima. 
Retoma o indice de uma cortalpha ou sua alternativa mais 
próxima, 

Aplica uma correção gamma em uma imagem GD. 

Define a cor pata o índice da paleta especificada. 

Obtém as cores para um índice. 

Retorna o número de cores de uma paleta de imagens. 
Define uma cor como transparente. 

Copia parte de uma imagem. 

Copia e une parte de uma imagem. 

Copia e une parte de uma imagem com tons de cinza. 
Copia e redimensiona parte de uma imagem. 

Copia e redimensiona parte de uma imagem com resampling. 
Cria uma nova imagem. 

Cria uma nova imagem true color. 

Converte uma imagem de true color para palette. 


Cria uma nova imagem a partir de um arquivo GD2 ou de um 
URL: 


Cria uma nova imagem baseada em uma parte de um arquivo 
GD2 ou de um URL. 


Cria uma nova imagem a partir de um arquivo GD ou de um 
URL. 


Cria uma nova imagem a partir de um arquivo GIF ou de um 
URL. 


Cria uma nova imagem a partir de um arquivo JPEG ou de um 
URL. 


Cria uma nova imagem a partir de um arquivo PNG ou de um 
URL. 


Cria uma nova imagem a partir de um arquivo WBMP ou de um 
URL. 


Retorna um identificador representando a imagem obtida de 
determinada string. 


Cria uma nova imagem a partir de um arquivo XBM ou de um 
URL. 


Cria uma nova imagem a partir de um arquivo APM ou de um 
URL. 


Desenha uma linha pontilhada. 
Destrói uma imagem. 

Desenha uma elipse. 

Preenche uma imagem ou parte dela. 


imageFilledAre 


imageFiledEllipse 
mageFilledPolygon 
imageF illedRectangle 
mageFilToBorder 
imageFontHeight 
mageFontWidth 
mageFtbBox 


mageFtText 
mageGD2 
mageGD 
mageGIF 
magePNG 
imageJPEG 
mageWBMP 
Imagelnterlace 
imagelsTrueColor 
imageLine 
imageLoadFont 
imagePaletteCopy 
magePolygon 
imagePSBBox 
magePSCopyFont 


magePSEncodeFont 
imagePSExtendPont 
imagePSFreeFont 
magePSLoadFont 
magePsExtendFont 
imagePsSlantFont 
magePSText 
ImageRectangle 
mageRotate 


ImageSaveAlpha 


cor. 

Desenha um elipse preenchida com uma determinada cor. 
Desenha um poligono preenchido. 

Desenha um retângulo preenchido. 

Preenche uma imagem com determinada cor. 

Obtém a altura da fonte. 

Obtém a largura da fonte. 


Usa fontes FreeType 2 para definir uma caixa (bounding box) 
para o texto. 


Escreve um texto em uma imagem usando fontes Free Type 2. 
Envia uma imagem GD2 para o browser ou para um arquivo, 
Envia uma imagem GD para o browser ou para um arquivo. 
Envia uma imagem GIF para o browser ou para um arquivo. 
Envia uma imagem PNG para o browser ou para um arquivo, 
Envia uma imagem JPEG para o browser ou para um arquivo. 
Envia uma imagem WBMP para o browser ou para um arquivo, 
Habilita ou desabilita o entrelaçamento, 

Verifica se uma imagem é true color (24 bits). 

Desenha uma linha. 

Carrega uma nova fonte. 

Copia a paleta de cores de uma imagem para outra. 
Desenha um poligono. 

Usa uma fonte Postscript e define uma caixa para o texto, 


Faz a cópia de uma fonte já carregada, para posterior 
modificação. 


Altera o vetor de codificação de caracteres para uma fonie. 
Estende ou condensa uma fonte, 

Libera a memória usada por uma fonte PostScript do tipo 1. 
Carrega a fonte PostScript tipo 1 de um arquivo. 

Estende ou condensa uma fonte. 

Inclina uma fonte. 

Desenha um texto sobre uma imagem. 

Desenha um retângulo. 

Realiza uma rotação em uma imagem, considerando o ângulo 
especificado. 

Usada em imagens PNG para configurar a flag que indica se 
as informações sobre o canal alfa (alpha channel) devem ser 
salvas. 


imageSetBrush 
imageSetStyle 
ImagesetTile 


imageSetThickness 


imageString 
imageStringUp 
imagesX 
imageSY 
imageTTFBBox 
imageTTF Text 
imageTypes 


ipicembed 
iptcparse 
ipegawbmp 
png2wbmp 
read exif data 


Matemática 


base convert 
bindec 

ceil 

cos 

cosh 

decbin 
dechex 
decoct 


Define um pixel simples. 

Define uma imagem para desenho de linhas. 

Define o estilo para o desenho de linhas. 

Define uma imagem (tile) para o preenchimento de uma área. 
Define a espessura de uma linha. 

Desenha uma string horizontalmente. 

Desenha uma string verticalmente. 

Retorna a largura da imagem. 

Retorna a altura da imagem. 

Utiliza fontes Type Type e define uma caixa para O texto. 
Escreve o texto na imagem usando fontes TrueType. 


Retoma o tipo das imagens suportadas pela compilação atual 
do PHP, 


Embute dados binários IPTC em uma imagem JPEG. 
Analisa um bloco binário IPTC em tags simples. 
Converte uma imagem JPEG para o formato WBMP. 
Converte uma imagem PNG para o formato WBMP. 
Apelido (alias) para a função exit read data. 


Valor absoluto. 

Arco cosseno. 

Arco cosseno hiperbólico. 

Arco seno. 

Arco seno hiperbólico. 

Arco tangente. 

Arco tangente de duas variáveis. 

Arco tangente hiperbólico. 

Converte um número entre duas bases arbitrárias. 
Converte de binário para decimal, 
Arredonda frações para cima. 

Cosseno. 

Cosseno hiperbólico. 

Converte de decimal para binário. 
Converte de decimal para hexadecimal. 
Converte de decimal para octal. 


Função Descrição (cont) 

deg2rad Converte um número de graus para radianos. ȚŢ7—~—— 

exp Eleva “e” a determinada potência, 

expmí Retoma exp(número)-1, calculado de forma precisa mesmo quando 
o número for próximo de zero, 

floor Arredonda frações para baixo. 

getrandmax Mostra o maior valor randômico possivel. 

hexdec Converte de hexadecimal para decimal. 

hypot Aplica a fórmula da hipotenusa aos valores fornecidos, ou seja, 
sgrifnum Pnum? + numZnum2). 

is finite Verifica se um valor em ponto flutuante é finito dentro dos limites da 
plataforma. 

is infinite Verifica se um valor em ponto flutuante é infinito dentro dos limites 
da plataforma. Exemplo: log(0). 

is nan Retoma frue se o valor fornecido não for um número (Not a 
Number. 

leg. value Retorna um número pseudo-aleatório entre O e 1, 

log Logaritmo natural. 

log10 Logaritmo de base 10. 

logip Retorna log/! + número), calculado de forma precisa mesmo 
quando o número for próximo de zero. 

max Retorna o maior valor. 

min Retorna o menor valor. 

mi rand Gera um valor randômico melhor. 

mi stand Define o melhor gerador de números randômicos. 

mit. getrandmax Mostra o maior valor randômico possivel. 

number format Formata um número. 

octdec Converte de octal para decimal. 

pi Retorna o valor do número pi. 

pow Eleva um número a outro, 

rad2deg Converte um número de radianos para graus, 

rand Gera um valor aleatório. 

round Arredonda um número em ponto flutuante. 

sin Seno. 

sinh Seno hiperbólico. 

sqrt Raiz quadrada. 

srand Define um- gerador de números aleatórios. 

tan Tangente. 


tanh Tangente hiperbólico. 


e det tie 


| Opções e informações do PHP 


recanto rc msm 
ese nc cte ren or remete 
PESTER OEEO 


a 


assert options 
extension, loaded 

di 

geteny 

get.cig. var 

get current user 

get defined constants 


get loaded extensions 
get extension Junes 
get required, files 


get included files 


get magic. quotes. gpo 


get magic quotes, runtime 


getlastmod 
getmygid 


getmyinode 
getmypid 
getmyuid 
getopt 


gelrusage 

ini alter 

ini get all 

ini gel 

ini restore 

ini set 

php. ini scanned, files 


phpcredits 
phpinfo 
phpversion 
php. logo. guid 
php sapi name 


Descrição 
Checa se uma declaração é falsa. 
Define/obtém diversas flags sobre o assen. 
Verifica se uma extensão foi carregada. 
Carrega uma extensão do PHP em tempo de execução. 
Obtém o valor de uma variável de ambiente. 
Obtém o valor de uma opção de configuração do PHP. 
Obtém o nome do dono do script PHP corrente. 
Retorna um array associativo com os nomes e valores das 
constantes definidas. 
Retorna um array com o nome dos módulos carregados. 
Retorna um array com os nomes das funções de um módulo. 
Retorna um array com os nomes dos arquivos requeridos em 
um seript. 
Retorna um array com os nomes dos arquivos incluídos em um 
script. 
Retorna a configuração ativa. 
Retoma a configuração ativa de magic. quotes. runtime. 
Retorna a hora de modificação da última página. 
Retorna o identificador do grupo (GID) do proprietário do script 
corrente. 
Retorna o inode do script corrente. 
Retorna o ID do processo PHP. 
Retorna o UID do dono do seript. 


Retorna um array associativo com pares opções/argumentos, 
baseado na lista de argumentos da linha de comando. 


Obtèm os recursos que estão sendo utilizados. 

Altera o valor de uma opção de configuração. 

Obtém o valor de todas opções de configuração. 

Obtém o valor de uma determinada opção de configuração. 
Restaura o valor de uma opção de configuração. 

Define o valor de uma opção de configuração. 


Retorna uma lista de arquivos ini analisados após o php.ini. Os 
elementos são separados por virguias. 


Imprime os créditos do PHP. 

imprime informações sobre o PHP. 

Retorna a versão do PHP. 

Obtém o logo guid. 

Retorna o tipo de interface entre o servidor Web e o PHP. 
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PDF 
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= Descrição (cont.) 


php uname 

putenv 

set magic. quotes, runtime 
set time limit 

version compare 


zend jogo guid 
zend version 


pof add bookmark 
pdf add, launchiink 
pdf add Jocallink 
pdf add note 

pdf add. pdfiink 


pdf add thumbnail 
pdf add. weblink 


pdf aro 

pdf arcn 

pdf aitach, file 
pot begin. page 
pdf. begin. patiem 


pdf begin. template 
pof circle 

pdf clip 

pdf close Image 

pdf close pdi page 
pdf_close_pdi 

pdf close 


[es 


pdf closepath. fill stroke 


paf closepath, stroke 


Retorna informações sobre o sistema operacional, 
Define o valor de uma variável de ambiente. 

Define a configuração ativa de magic. quotes. runtime. 
Limita o tempo máximo de execução. 


Compara duas strings padronizadas, contendo o número da 
versão do PHP. 


Obtém o zend guid. 
Obtém a versão da ferramenta Zend, 


Descrição 


Adiciona um bookmark à página corrente. 

Cria um link para um arquivo, URL ou outro recurso, 
Adiciona um link local. 

Adiciona notas em um documento PDF. 


Adiciona à página corrente um link para um arquivo PDF 
externo, 


Adiciona à página corrente uma miniatura (thumbnail). 


Adiciona um weblink à página corrente através da definição de 
uma área retangular, 


Desenha um arco em sentido anti-horário. 

Desenha um arco em sentido horário. 

Anexa um arquivo a um documento PDF na forma de um icone, 
inicia uma nova página no documento. 


Inicia a definição de um novo padrão (pattern), que poderá ser 
utilizado para o preenchimento de objetos. 


Inicia a definição de um novo modelo (template). 

Desenha um circulo. 

Seleciona o caminho atual, definindo-o como clip path. 
Fecha uma imagem. 

Fecha uma página aberta com a função pdf. open. pdi page. 
Fecha um documento PDI aberto com a função pdf open. pe. 


Fecha um objeto PDF e libera todos os recursos associados a 
ele, 


Completa o caminho corrente (adicionando uma linha do último 
ao primeiro ponto), preenchendo-o e desenhando-o no 
documento. 


Completa o caminho corrente (adicionando uma linha do último 
ao primeiro ponto) e o desenha no documento, 


pt. df. closepath 
pdf. concat 


pdf. continue, text 
pdf curveto 


pdf delete 

pdf end. page 
pdf end pattem 
pdt end. template 


pdf. fill stroke 
pot. fill 

pdf. findfont 
pdf get buffer 


pdf get majorversion 
pdf get minorversion 


pdf get parameter 
pdf. get pdi parameter 


pdf get pdi value 
pdf get value 
pdf initgraphics 


pdf, lineto 

pat, makespotcolor 
pdf. moveto 

pot new 

pdf open. CCITT 


pdf open. file 
pdf open, image. file 
pdf open image 


233 


ao primeiro ponto. 


Concatena uma matriz à atual matriz utilizada para 
transformação de textos e gráficos (CTM). 


Escreve um texto na próxima linha do documento. 


Desenhauma curva Bezier a partir do ponto corrente, utilizando 
outros três pontos de controle. 


Exclui um objeto PDF e libera todos os recursos associados a 
ele. 


Encerra uma página do documento, iniciada pela função 
pdf begin page. 

Enderra a definição de um padrão, iniciada pela função 
pdf. begin, pattern. 


Encerra a definição de um modelo (template), iniciada pela 
função pof, begin, template. 


Preenche o caminho atual e o desenha no documento. 
preenche o caminho atual. 
Prepara uma fonte para uso posterior. 


Obtém o conteúdo do buffer onde estão localizados os dados 
referentes ao documento PDF gerado. 


Retorna o número da maior versão disponivel da biblioteca 
PDFlib. 


Retorna o número da menor versão disponivel da biblioteca 
PDPlib. 


Obtém o valor de um determinado parâmetro do documento. 


Obtém o valor de um determinado parâmetro de um documento 
PDI. 


Obtém o valor de um parâmetro númerico de um documento 
PDI. 


Obtém o valor de um determinado parâmetro numérico do 
documento. 


Reinicia todos os parâmetros gráficos e de cores, fazendo-os 
assumir os seus valores padrão. 


Desenha uma linha. 

Define a cor atual como sendo uma cor especial chamada spot. 
Define o ponto corrente. 

Cria um novo objeto PDF. 


Abre um novo arquivo de imagem contendo dados comprimidos 
do tipo CCITT. 


Cria um novo arquivo PDF. 
Lê uma imagem de um arquivo. 
Usa dados de uma imagem a partir de diversas origens. 
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Descrição (conto) 


pdf open. memory. image 


pdf open, pdi page 
pdf open. pdi 


pdf place image 
pdf place pdi page 


pdf rect 
pdf restore 


pdf rotate 

pof save 

pdf scale 

pof set border. color 


pof set border dash 
pdf set border style 
pdf set info 


pdf set parameter 
pof set text pos 
pot set value 


pdf setcolor 
pdf. setdash 
pdf setflat 


pof setfont 
pdf setlinecap 


pdf setlinejoin 
pdf setlinewidth 


pdf setrmatrix 
pdf setmiterimit 
pdf setpolydash 


pdf show boxed 


Abre uma imagem criada com as funções de imagem do PHP, 
tornando-a disponivel para o objeto PDF. 


Abre uma página no documento PDI especificado, 


Abre q documento PDF especificado e retorna o identificador 
do objeto PDI. 


insere uma imagem na página corrente. 


insere uma página de um documento PDI em um documento 
PDF. 


Desenha um retângulo. 


Restaura o último estado dos gráficos salvo pela função 
pdf save, 


Realiza uma rotação no sistema de coordenadas, 
Salva o estado gráfico corrente do documento, 
Define a escala do sistema de coordenadas. 


Define a cor da borda a ser utilizada em torno de links e 
anotações. 


Define o estilo de pontihado a ser utilizado em torno de links e 
anotações. E 


Define o estilo de borda a ser utilizado em torno de links e 
anotações. 


Define os campos de informação sobre um documento, que 
serão exibidos quando o usuário visualizar suas propriedades. 


Altera o valor de um determinado parâmetro do documento, 
Define a posição corrente para inserir textos no documento. 


Altera o valor de um determinado parâmetro numérico do 
documento. 


Define a cor de preenchimento ou de contorno, 
Define o padrão de pontilhado. 


Define a distância máxima (fatness) entre o caminho de um 
objeto e uma aproximação criada com linhas. 


Define a fonte corrente, assim como o seu tamanho. 


Altera o valor do parâmetro linecap, que faz com que a linha 
seja desenhada de forma diferente. 


Configura o tipo de junção entre duas linhas. 


Define a espessura da linha que será utilizada para desenhar 
as figuras. 


Define a matriz corrente para transformações. 
Configura o limite miter para um valor maior ou igual a 1, 


Define um padrão de pontilhado mais complexo, baseado em 
um array. 


Cria uma caixa de texto. 


pot: “show xy y een 
pat show 

pdf skew 

pdf. stringwidth 


pat stroke 
pdf translate 


Sessões 


Função 


session start, 

session desiroy 
session name 

session module name 
session save path 


session. id 

session regenerate id 
session, register 

session unregister 

session unsel 
session is registered 
session get cookie params 
session set cookie params 
session decode 

session, encode 
session set save, handler 


session cache, limiter 
session cache expire 
session write close 


Descrição (e (cont. ) 


“ Escreve um texto em n um determinado ponto do documento, 
utilizando a fonte corrente. 


Escreve um texto no ponto corrente do documento, utilizando 
a fonte corrente. 


inclina o sistema de coordenadas do documento nos eixos x € 
y. 

Retorna a largura de um texto utilizando uma determinada 
tonte. 


Desenha uma linha em torno do caminho corrente. 
Define a origem do sistema de coordenadas. 


Inicial za uma sessão. 
Destrói todos os dados registrados em uma sessão. 
Obtém e/ou define o nome da sessão corrente. 
Obtém e/ou define o módulo da sessão corrente. 


Obtém e/ou define o caminho de onde serão armazenados 
os dados da sessão corrente. 


Obtém e/ou define o ID da sessão corrente. 

Gera um novo identificador para a sessão corrente. 
Registra uma ou mais variáveis na sessão corrente, 
Exclui uma variável da sessão corrente. 

Limpa todas as variáveis da sessão. 

Verifica se uma variável está registrada em uma sessão. 
Obtém parâmetros dos cookies da sessão. 

Define parâmetros dos cookies da sessão, 

Decodifica dados da sessão em uma string. 

Codifica dados da sessão corrente em uma string. 
Define funções de armazenamento da sessão em nivelde 
usuário. 

Obtém e/ou define O limitador atual da cache. 

Retorna o tempo (em minutos) de expiração da cache. 
Encerra a sessão corrente e armazena às seus dados. 


basename 
chgrp 

chmod 

chown 
clearstatcache 
copy 

delete 

dimame 
diskfreespace 
disk total space 
diskirsespace 
fclose 

feof 

Mush 

fgeto 

fgetesv 

fgets 

fgetss 

file 
file_exists 

file get contents 
fila. put contents 
fileatime 
filectime 
filegroup 
fileinode 
filemtime 
filgowner 
fileperms 
filesize 

filetype 

flock 

frrmateh 


fopen 
fpassthru 
fputs 


Desenvolvendo Websites com PHP 


Sistema de arquivos (Filesystem) 


Descrição 


Retorna o nome do arquivo em um caminho, 

Altera o grupo de um arquivo. 

Altera as permissões de um arquivo. 

Altera o dono de um arquivo. 

Limpa a cache do arquivo. 

Copia arquivos. 

Exclui um arquivo. 

Retoma o nome do diretório contido em um caminho, 
Retorna o espaço disponivel em um diretório. 
Retoma o tamanho total de um diretório. 

Apelido (alias) para a função disk free. space(). 
Fecha um ponteiro de arquivo. 

Testa se o ponteiro está no final do arquivo, 

Grava os dados da memória em um arquivo. 
Obtém caracteres a partir da posição do ponteiro, 
Obtém uma linha do arquivo e converte em campos CSV. 
Obtém uma linha do arquivo, 

Obtém uma linha do arquivo e retira as tags HTML, 
Lê um arquivo inteiro e o armazena em um array. 
Testa se determinado arquivo existe. 

Lê o conteúdo inteiro de um arquivo para uma string. 
Escreve uma string em um arquivo. 

Obtém a hora do último acesso ao arquivo. 

Obtém a hora de alteração do descritor do arquivo. 
Retorna o grupo do arquivo. 

Retorna o inode do arquivo. 

Retorna a hora que o arquivo foi modificado. 
Retorna o dono do arquivo. 

Retorna as permissões do arquivo. 

Retorna o tamanho do arquivo. 

Obtém o tipo do arquivo. 

Blogueia um arquivo. 


Testa se o nome do arquivo possui um determinado padrão 


(pattern). 

Abre um arquivo ou um URL. 

Imprime os dados restantes de um arquivo. 
Escreve em um arquivo. 


Função Descrição (cont) 0 
read q Lê um arquivo (binário). 
fscanf interpreta a entrada de um arquivo conforme determinado formato. 
fseek Posiciona o ponteiro do arquivo em um local determinado, 
fstat Obtém informações sobre um arquivo. 
fteil Retorna a posição dó ponteiro do arquivo. 

ftruncate Trunca um arquivo em determinado tamanho. 

write Escreve em um arquivo. 

glob Busca por diretórios e arquivos que possuem um determinado 

padrão (patter). 

is dir Testa se o arquivo é um diretório. 

is executable Testa se o arquivo é executável, 

is file Testa se o arquivo é regular. 

is link Testa se o arquivo é um link simbólico. 

is readable Testa se o arquivo tem permissão de leitura. 

is writable Testa se o arquivo tem permissão de escrita. 

is wniteable Tem a mesma função do comando is. writable. 

is uploaded, file Testa se o arquivo foi enviado por upload via HTTP POST. 
link Cria um link fisico. 

linkinfo Obtém informações sobre urn link. 

mkdir Cria um diretório, 

move, uploaded, file Move um arquivo enviado por upload. 

parse. int file Analisa um arquivo de configuração (ini). 

pathinfo Retorna informações sobre o caminho (path). 

pelose Fecha o ponteiro para um processo. 

popen Abre o ponteiro para um processo. 

eadfile Lê um arquivo e o imprime na saida-padrão. 

readlink Retorna o alvo de um link simbólico. 

ename Renomeia um arquivo. 

ewind Retrocede a posição de um ponteiro de arquivo. 

mdir Remove um diretório. 

stat Obtém informações sobre um arquivo. 

stat Obtém informações sobre um link simbólico. 

realpath Retorna o nome absoluto do caminho. 
set file buffer Configura o buffer de arquivo. 

symlink Cria um link simbólico. 
tempnam Cria um nome único de arquivo. 
tmpfile Cria um arquivo temporário. 
touch Define a hora de modificação de um arquivo. 
umask Altera a máscara atual. 


unlink Exclui um arquivo. 


addSlashes 
binzhex 

chop 

chr 

chunk split 
convert_eyr_string 
count chars 

credo 

crypt 

echo 

explode 

get html translation, table 


hebrev 
hebrevo 


himl entity decode 


htmientities 
htmispecialchars 
implode 


join 
levenshtein 
ocalecony 


trim 

ds file 

d5 
metaphone 
oney format 
ni Janginfo 


br 


number format 


Colocauma barra invertida (1) antes de determinados caracteres 
Coloca \ antes dos caracteres |,“ e), 

Converte um dado de binário para hexadecimal, 

Remove espaços e quebras de linha do final da string. 
Retorna um caractere específico, 

Divide uma string em pequenos pedaços, 

Converte um caractere do tipo Cyrillic para outro, 

Retorna informações sobre caracteres usados em uma string. 
Calcula o crc32 polinomial de uma string. 

Codifica uma string. 

Imprime uma string em determinada saída. 

Forma um array através de uma string. 


Retorna a tabela de tradução usada pelas funções 
htmispecialchars() e himientitiesQ. 


Converte texto lógico Hebrew para texto visual, 


Converte texto lógico Hebrew para texto visual convertendo o 
caractere \n para “<br>in”, 


Converte todas entidades HTML para os seus respectivos 
caracteres, 


Converte todos os caracteres aplicáveis para entidades HTML. 
Converte caracteres especiais para entidades HTML. 


Forma uma string por meio da união dos elementos de um 
array. 


Similar à função implode. 
Calcula a distância Levenshtein entre duas strings. 


Retorna um atray contendo informações numéricas e 
monetárias. 


Remove espaços em branco do inicio de uma string. 
Calcula o hash MDS de um determinado nome de arquivo, 
Calcula o hash MDS de uma string. 

Calcula a chave metaphone de uma string. 

Aplica um determinado formato de moeda a um número. 


Retorna informações sobre algumas configurações do sistema, 
como formatos e localidade. 

insere quebras de linha HTML antes de todas as quebras de 
linha de uma string. 


Formata um número, permitindo definir o separar decimal e de 
milhar, 


parse. str 
print 
printf 


quoted, printable. decode 


quotemeta 
ririm 
sscanf 
setlocale 
shai_file 


shat 
similar text 
soundex 
sprintf 

str ireplace 


str rotia 
str shuffle 


str word  couni 
strcasecmp 


strcasecmp 
strchr 
siremp 
strcoll 
strespn 


strip tags 
striposlashes 
stripslashes 
stristr 

strlen 
simatemp 
stmatcasecmp 


strnemp 
str pad 
strpos 


Divide uma string em variáveis. 
Imprime o valor de uma string. 
imprime o valor de uma string com formatação. 
Converte uma string para 8 bit. 
Coloca o caractere \ antes de determinados caracteres, 
Remove espaços no final da string, incluindo quebras de linha. 
Divide uma string de acordo com um formato. 
Ajusta informações do local. 
Calcula o hash shat (Secure Hash Algorithm 1) de um 
determinado arquivo. 
Calcula o hash shat (Secure Hash Algorithm 1) de uma string. 
Calcula a similaridade entre duas strings. 
Calcula a chave soundex de uma string. 
Retorna uma string formatada. 
Versão case-insensitive (não diferencia maiúsculas € 
minúsculas) da função str. replace(). 
Realiza uma transformação rot13 em uma string. 
Retorna uma string com a posição de seus caracteres alterada 
de forma aleatória. 
Conta o número de palavras existentes em uma string. 
Comparação binária (case-insensitive) dos n primeiros 
caracteres. 
Comparação binária (case-insensilive). 
Encontra a primeira ocorrência de um caractere. 
Comparação binária. 
Compara duas strings no local corrente. 


Encontra o tamanho do segmento inicial da string que não 
contém a máscara de comparação. 


Retira tags HTML e PHP de uma string. 

Retira o caractere \ colocado com a função addeslashes{). 
Retira o caractere \ colocado com a função addisiashesQ. 
Versão case-insensitive da função strstr). 

Obtém o tamanho de uma string. 

Compara strings usando o algoritmo “natural order”, 


Faz uma comparação case-insensitive de strings usando o 
algoritmo “natural order” . 


Comparação binária dos n primeiros caracteres. 
Preenche um certo tamanho da string com outra string. 
Encontra a posição da primeira ocorrência de uma string. 


URL 
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strrchr 

str repeat 
strrev 
strrpos 


strspn 


strstr 

strtok 
strtolower 
strioupper 
str replace 
strir 

substr 
substr_count 
substr_replace 
trim 

uctirst 
ucwords 


vprintf 
vsprintf 


wordwrap 


Função 
base64 decode 
base64 encode 
parse url 
uridecode 
urlencode 


Encontra a última ocorrência de um caractere. 


Decodifica dados codificados com MIME base64, 


Descrição (cont.) 


Repete uma string. 
Reverte uma string. 


Encontra a posição da última ocorrência de um caractere em 
uma string. 


Encontra o tamanho do segmento inicial da string que contém 
a máscara de comparação. 


Encontra a primeira ocorrência de uma string. 

Divide uma string em partes conforme um parâmetro. 
Transforma uma string em letras minúsculas. 

Transforma uma string em letras maiúsculas. 

Substitui todas as ocorrências de uma string por outra. 
Substitui alguns caracteres por outros. 

Retorna uma parte da string. 

Conta o número de ocorrências de uma substring. 

Substitui textos dentro de uma substring. 

Remove os espaços em branco do início e do fim da string. 
Transforma o primeiro caractere de uma string em maiúsculo. 
Transforma em maiúsculo o primeiro caractere de cada palavra 
contida em uma string. 

Exibe os valores de um array de acordo com o formato 
especificado. Não possui valor de retorno. 

Retorna os valores de um array de acordo com o formato 
especificado. 


Coloca quebras de linha em uma string após determinado 
número de caracteres, 


Descrição 
Codifica dados com MIME base64. 

Separa uma URL e retorna seus componentes. 
Decodifica uma URL codificada. 

Codifica uma URL. 
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Variáveis 
Função Descrição OO 
doubleval Retoma o valor de uma variável em ponto flutuante. 
empty Testa se o conteúdo de uma variável é nulo. 
fioalval Obtém o valor de uma variável em ponto flutuante. 
gettype Obtém o tipo da variavel, 


get defined vars 

get resource type 
import request variables 
intval 

is array 

is. bool 

is callable 


is double 
is fiat 

is int 

is integer 
is long 

is null 
is_numeric 
is_object 
is_real 

is resource 
is scalar 
is string 
isset 
print_r 
serialize 
settype 
strval 
unserialize 
unset 
var_dump 
var export 


Retoma um array com todas as variáveis definidas. 

Retorna o tipo do recurso. 

importa as variáveis GET/POST/Cookie em um escopo global. 
Retorna o valor inteiro de uma variável. 

Testa se uma variável é um array. 

Testa se uma variável é do tipo bool. 


Verifica se o conteúdo de uma variável pode ser chamado 
como uma função. 


Testa se uma variável é do tipo double. 

Testa se uma variavel é do tipo ponto flutuante, 

Testa se uma variável é do tipo inteiro. 

Testa se uma variável é do tipo inteiro, 

Testa se uma variável é do tipo inteiro. 

Testa se uma variável é nula. 

Verifica se uma variável é um número ou uma string numérica, 
Testa se uma variável é um objeto. 

Testa se uma variável é do tipo real. 

Testa se uma variável é um recurso, 

Testa se uma variável é escalar. 

Testa se uma variável é uma string. 

Verifica se uma variável está definida. 

imprime informações sobre uma variável, 

Gera uma representação armazenável de um valor. 

Define o tipo de uma variável. 

Retorna a variável como uma string. 

Cria um valor em PHP para uma representação armazenada. 
Exclui uma variável do programa, 

Retorna informações sobre uma variável, 


Retorna uma representação estruturada de uma determinada 
variável, 


Apêndice B 
Funções PHP/bancos de dados 


Neste apêndice veremos uma lista de funções do PHP que podem ser utiliza- 
das para realizar a integração com diversos SGBDs, como MySQL, PostgreSQL, 
InterBase, Oracle, SQL Server etc. 


MySQL 


Função Descrição CO F 

mysal_affected_rows — > Obtém o número de linhas afetadas em uma operação. 

mysql change, user Altera o usuário na conexão ativa. 

mysql.client encoding Retorna o nome do conjunto de caracteres utilizado pelo 
cliente. 

mysql_close Fecha uma conexão MySQL. 

mysql connect Abre uma conexão com o servidor MySQL. 

mysgl data seek Move o ponteiro interno de resultado. 

mysal. db. name Obtém dados do resultado. 

mysql.errmo Retorna o número do erro de uma operação executada. 

mysql error Retorna a mensagem de erro de uma operação executada. 

mysql escape. string Adiciona caracteres de escape a uma string, para que ela 
possa ser usada em um comando SQL sem gerar erros na 
sintaxe. 

mysql fetch, array Coloca uma linha do resultado em um array associativo, 
numérico ou ambos. 

mysql fetch assoc Coloca uma linha do resultado em um array associativo, 

mysql fetch field Retorna um objeto com informações sobre um campo da 
consulta. 

mysql fetch lengths Retorna o tamanho de cada campo em uma consulta 

mysgl fetch. object Busca o resultado como um objeto. 


mysql fetch row Obtém uma linha do resultado como um array enumerado. 
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field table 
ield type 
free result 


mysql get..client info 


mysg 
mysql 


mysq 
mysq 
mysq 


mysg 
mysq 


mysq 


get host info 
get proto. info 
gel server. info 
info 


nsert id 


list dbs 
| list fields 


list processes 


list tables 
num, fields 
num, rows 
 pconnect 
-ping 


| query 
| real escape. string 


result 
select db 
| stat 


Jablename 
thread dd 


 unbuffered query 


Retornaos flags associados a um campo de uma consulta, 
Retorna o nome de determinado campo. 

Retorna o tamanho de determinado campo, 

Posiciona o ponteiro para um campo especifico da consulta, 
Retorna o nome da tabela à qual o campo pertence, 
Retorna o tipo de determinado campo. 

Libera a memória reservada para uma consulta. 
Retorna informações sobre a versão do cliente MySQL. 
Retorna o tipo de conexão estabelecida com o servidor. 
Retorna informações do protocolo utilizado na conexão, 
Retorna a versão do servidor MySQL. 


Retorna informações detalhadas sobre a última consulta 
realizada. 


Obtém o ID gerado por uma operação INSERT executada 
anteriormente. 


Lista os bancos de dados existentes no servidor MySQL. 
Lista os campos do resultado. 


Lista os processos do MySQL. Retorna um ponteiro para 
os resultados, que descrevem as threads atuais, 


Lista tabelas em um banco de dados MySQL. 

Retorna o número de campos do resultado, 

Retorna o número de linhas do resultado, 

Abre uma conexão persistente com um servidor MySQL. 


Envia um ping para verificar se a conexão com o servidor 
está ativa. Se não estiver, tenta reconectar 
automaticamente, 


Envia uma consulta MySQL. 


Adiciona caracteres de escape a uma string, para que ela 
possa ser usada em um comando SQL. Considera o 
conjunto de caracteres em uso na conexão, 


Obtém os dados do resultado, 
Seleciona um banco de dados MySQL, 


Retorna uma string contendo informações sobre o estado 
corrente do sistema. 


Obtém o nome da tabela do campo. 


Retorna um valor inteiro que representa o identificador da 
thread atual. 


Envia uma consulta SQL ao servidor MySQL, sem 
armazenar em um buffer as linhas resultantes, 


| Apêndice B * Funções PHP/bancos 


Função 


mysgll affected rows 
mysql autocommit 


mysql bind param 
mysql bind. resul 


mysgl change. user 


mysajl character set name 


mysoji client encoding 
mysgll close 

mysqli commit 

mysql connect ermno 
mysqli conhect error 
mysgjil connect 

mysgli data seek 
mysqli debug 


mysali disable reads from master 


mysql, disable mpi parse 
mysqli dump debug. into 


mysqli embedded. connect 
mysql enable reads from master 


mysgli enable rp! parse 
mysql emo 

mysqli error 

mysql escape string 
mysql execute 

mysgl fetch array 


mysql, fetch assoc 
mysgjl fetch. field direct 
mysqli_fetch_field 


mysqli_fetch_fields 


mysqli_fetch_lengths 
mysqli_fetch_object 
mysgli_fetch_row 
mysgii fetch 


mysgli field count 
mysgli figld seek 
mysql. field. tel 


a 


da 


Descrição 


Obtém onúmerode linhas afetadas em uma operação. 


Habilita ou desabilita a confirmação automática (autocomenil 
das modificações. 


Associa uma variável a um parâmetro de um comando 
preparado. 


Associa uma variável a um comando preparado, para 
armazenamento do resultado. 


Altera o usuário na conexão ativa. 

Retorna onome do conjunto de caracteres utilizado pelocliente. 
Apelido para mysqli character, set named. 

Fecha uma conexão MySQL. 

Confirmaa transação corrente. 

Retorna o código de erro da última chamada de conexão. 
Retorna a descrição do erro da última chamada de conexão. 
Abre uma conexão com o servidor MySQL. 

Move o ponteiro interno de resultado. 

Realiza operações de depuração. 

Desabilita a leitura do servidor Master. 

Desabilita a análise (parse) RPL. 

Gravainformações de depuração no registro (log) do MySQL. 
Abre uma conexão com um servidor MySQL embutido. 
Habilita a teitura a partir do servidor Master. 

Habilita a análise (parse) RPL. 

Retorna o numero do erro de uma operação executada. 
Retorna a mensagem de erro de uma operação executada. 
Apelido para mysqli real escape. stringQ. 

Executa uma consulta previamente preparada. 


Coloca uma linha do resultado em um array associativo, 
numérico ou ambos. 


Coloca uma linha do resultado em um array associativo. 
Obtêmos metadados para um determinado campo. 


Retorna um objeto com informações sobre um campo da 
consulta. 


Retorna um array de objetos com informações sobre os 
campos da consulta. 


Retorna o tamanho de cada campo em uma consulta 
Buscao resultado como um objeto. 

Obtém uma linha do resultado como um array enumerado. 
Armazenanas variáveis associadas (bind) os resultados de 
umcomando preparado. 

Retorna o número de colunas da consulta mais recente. 
Posiciona o ponteiro para um campo específico da consulta, 


Retorna o número do campo corrente em um ponteiro de 
resultado. 


Função 


mysoli get client info 
mysgl get host info 

mysqli get metadata 
mysgl get proto info 
mysgl get server. info 
mysgli get server version 
mysgl into 


mysgl init 

mysgi insert id 
mysgli_kill 

mysqli _master_query 
mysgli_more_results 


mysqli multi query 
mysgl next result 


mysgl num fisids 
mysqli num. tows 
rmysgli options 
mysgl param count 
mysqli ping 


mysgil prepare 

mysgli query 
mysgli real connect 
mysql real escape. string 


mysgli real query 
mysql report 

mysgli roliback 

mysgli select db 
mysgli send jong data 
mysql send query 
mysgjli server end 
mysali server int 
rmysali set charset 
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Descrição (cont.) 

Liberaa memória reservada para uma consulta. 
Retorna informações sobre a versão do cliente MySQL. 
Retorna otipo de conexão estabelecida com o servidor. 
Apelido para mysgl simt result metadata(. 

Retorna informações do protocolo utilizado na conexão. 
Retorna a versão do servidor MySQL. 

Retorna a versão de um servidor MySQL como um inteiro, 


Retorna informações detalhadas sobre a última consulta 
realizada. 


inicializa a MySQLie retorna um recurso para uso na função 
mysgli real connect, 


Obtém o ID gerado por uma operação INSERT executada 
antenormente. 


Solicita ao servidor o encerramento de um determinado 
processo (thread) MySQL. 

Emuma configuração master/slave (mestre/escravo), força 
a execução da consulta no master, 

Verifica se há mais resultados em uma consulta múltipla (multi 
query). 

Executa uma ou mais consultas em um banco de dados. 
Prepara o próximo resultado de uma consulta múltipla (multi 
query). 

Retorna o número de campos do resultado, 

Retorna o número de linhas do resultado. 

Configura opções do MySQL. 
Retomaonúmerodeparâmetros de um determinado comando, 
Envia umpingparaverificar se a conexão como servidor está 
ativa, Se não estiver, tenta reconectar automaticamente. 
Prepara um comando SQL para execução. 

Envia uma consulta MySQL. 

Abre uma conexão com um servidor MySQL. 


Adiciona caracteres de escape a uma string, para que ela 
possa serusada em um comando SAL. Considera o conjunto 
de caracteres em uso na conexão. 


Executa uma consulta SQL. 

Habilita ou desabilita as funções internas que reportamerros, 
Cancela a transação corrente. 

Seleciona um banco de dados MySQL. 

Apelido para mysql stmt send long data). 

Envia uma consulta e retorna. 

Encerra o servidor MySQL embutido (embedded). 
Inicializa o servidor embutido (embedded) MySQL. 

Define o conjunto de caracteres padrão do cliente. 
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função 

mysql set opt 

mysql salstate 
mysgl, ssi set 

mysali stat 

mysqli stmt affected rows 


mysgl, simt bind, param 
mysql. stmt bind. result 


mysqli stmt close 
mysql stmt data seek 
mysgli stmi ermo 


mysgll stmt error 


mysql stmt execute 
mysqli simt, fetch 


mysql stmt free. result 
mysql stemí int 
mysqli stmt num towS 
mysql stmt param. count 
mysall simt prepare 
mysqli stmt reset 

mysql stmt result metadata 
mysql stmt send long. data 
mysql stmt salstate 

mysgl store, result 

mysql. thread id 

mysal, thread sale 


mysql use, result 


mysql, waming count 


Descrição (cont.) 


“ Apelido paramysai options). 


Retoma erro SOLSTATE referente à última operação do 
MySQL. 

Estabelece uma conexão segura com O MySQL usando 
SSL. 


Retorna uma string contendo informações sobre o estado 
corrente do sistema. 


Número de inhasalteradas, excluídas ouinseridas pelo último 
comando executado. 


Associa variáveis aos parâmetros de um comando preparado. 


Associa variáveis a um comando preparado para 
armazenamento do resultado. 


Fechaumcomando. 
Procura porumadeterminadalinha noconjunto de resultados. 
Retomaocódigade erroreferente aoultimo comandoexecutado. 


Retorna a descrição do erro referente ao ultimo comando 
executado. 


Executa uma consulta preparada. 

Busca resultados a partir de um comando preparado, 
armazenando-os nas variáveis associadas. 

Libera a memória alocada pelo resultado do comando 
especificado. 

Inicializa um comando e retorna um objeto para uso com 
mysgl stmt prepare. 

Retoma o número de linhas existentes no conjunto de 
resultados do comando. 

Retorna onúmero de parâmetros do comando especificado. 
Prepara um comando SQL para execução. 

Reinicia um comando preparado. 


Retorna os metadados do conjunto de resultados de um 
comando preparado. 


Envia dados em blocos. 

Retorna erro SQLSTATE referente à última operação. 
Transfere o resultado da última consulta para ser usado pela 
função mysali data, seek). 


Retoma umvalorinteiroque representa identificador da thread 
atual. 


indica se a segurança de um processo (thread) está definida 
ounão. 

Inicia o retro de um resultado (result setida última consulta 
executada por mysali real query0. 

Retorna onúmero de avisos (warnings) gerados pela última 
consulta executada. 
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PostgreSQL 


Função 


pg. affected rows 


pg cancel query 


pg. client encoding 


pg. close 
pg. connect 


pg. connection, busy 
pq. connection reset 
pg. connection status 


pq convert 


pq copy from 
pg. copy.to 

pg .dbname 

pg. delete 

pg.end copy 

py escape. bytea 


pa escape string 
pg fetch al 


pg fetch array 
pg fetch assoc 
pg fetch object 
pg. fetch result 


pg fetch row 
pg field name 
pg. field num 
pq field prilen 
pg feld size 
pg. Heldhype 
pg fee resul 


Descrição 


Retorna o número de registros afetados por uma operação 
INSERT, UPDATE ou DELETE, Antigamente, essa função 
erachamada de pg affected rows(). 


Cancela uma consulta assincrona enviada pela função 
pg. send quervl). 

Retorna a codificação de caracteres usada pelocliente. 
Fecha uma conexão PostgreSQL. 

Abre uma conexão PostgreSQL, 

Verifica se uma conexão está ocupada ou não. 

Reinicia uma conexão. É útil para recuperação de erros. 


Retorna o estado da conexão (PGSOL CONNECTION OK 
ou PGSQL. CONNECTION BAD), 


Converte os valores de umarray associativo para uso emum 
comando SOL. 


Insere registros em uma tabela a partir de um array. 

Copia o conteúdo de uma tabela para um array. 

Retorna o nome do banco de dados. 

Exclui registros de acordo com uma determinada condição, 
Sincroniza com o backend do PostgreSQL. 


Adiciona caracteres de escape a uma string do tipo de dados 
bytea. 


Adiciona caracteres de escape a uma string. 


Retorna umarray contendo todas as linhas resultantes de uma 
consulta. 


Retorna uma linha do resultado como um array., 

Retorna uma linha do resultado em um array associativo. 
Retorna uma linha do resultado como um objeto. 

Relurna valores a partir de um recurso do tipo result retomado 
pela função pg. query). 

Retorna uma finha do resultado como um array enumerado, 
Testa se um campo é nulo. 

Retorna o nome do campo. 

Retorna o número do campo. 

Retorna o tamanho do campo para impressão. 
Retorna o tamanho do campo definido no banco de dados. 
Retorna otipo de dado de um campo da consulta. 

Libera a memória alocada para uma consulta. 


Função 

pa get not 
pg. get pid 
pg get result 


pg host 

pq. insert 

pg last error 
pq. last notice 
pq last old 
panosti 
pg. lo. close 
pq. lo create 
palio expor 
pg. lo impor 
pa lo open 
palo read 
pgto read al 
pg lo seek 
pg. lo tel 

pg to uniink 
pq.io write 
pg meta data 
pg.num, fields 
pg num rows 
pa options 

pg. peonnect 
pg. ping 


pa por 
pg put line 


Pa. query 


pg result error 
pa. result seek 
pq result status 
pg select 

pg. send query 
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Descrição (cont.) 


Obtém o estado da conexão enviando um comando SQL 


NOTIFY. 


Retormao identificador do processo (PID) do servidor debanco 
de dados. 


Obtémos resultados de uma consulta assincrona, executada 
pela função pg. send. query(). 


Retorna o nome do servidor associado à conexão. 

insere os valores de um array associativo em uma tabela. 
Obtémauúltimamensagemdeerro paraaconexão especificada. 
Retornaa última mensagem gerada pelo servidor PostgreSQL. 
Retorno último identificador do objeto (OID). 

Retorna o nome do hostassociado com a conexão. 

Fecha um objeto extenso (large object). 

Cria um objeto extenso. 

Exporta um objeto extenso para um arquivo. 

Importa um objeto extenso de um arquivo. 

Abre umobjeto extenso. 

Lêumobjeto extenso. 

Lê umobieto extenso inteiro. 

Busca por uma posição em um objeto exienso. 

Retornaa posição corrente em um objeto extenso. 

Exclui um objeto extenso. 

Escreve em um objeto extenso. 

Obtémas metadados para uma determinada tabela. 
Retorna onúmero de campos de uma consulta, 

Retorna o número de linhas de uma consulta. 

Obtém opções associadas com uma conexão. 

Abreuma conexão persistente com um servidor PostgreSQL. 


Enviaum pingpara verificar sea conexão como servidor está 
ativa. Senão estiver, tenta reconectar automaticamente. 


Retorna o número da porta associado coma conexão. 


Envia string terminada em NULL para o backend do 
PostgreSQL. 


Executauma consulta. Antigamente, essa função erachamada 
de pg. exect). 


Obtém a mensagem de erro associada ao resultado. 
Configura o offsetinterno das linhas do resultado. 

Obtém estado do resultado de uma consulta. 

Seleciona registros de acordo com uma determinada condição. 


Envia uma consulta assincrona ao servidor. Os resultados 
são obtidos posteriormente pela função pg. gel. result). 


SQLite 


Função 


pq. set client. encoding 
pg. trace 


patty 
pg unescape bytea 


pa untrace 


pq update 


solte array query 


sglite busy. timeout 
salte changes 


saite close 
sqlite column 
saite create aggregate 


salte create function 


salite. current 


salte error string 
salte escape string 


saite exec 


sglite factory 


sajite fetch al 


salte feich array 


Descrição (cont.) 


Habilita o tracing em uma conexão PostgreSQL. 
Retorna o nome do terminal associado a uma conexão, 


Remove caracteres de escape de uma stringdotipo de dados 
bytea. 


Desabilita o tracing de uma conexão PostgreSQL. 


Atualiza registros em uma tabela de acordo com uma 
determinada condição, 


Descrição 


resultados em um array. É semelhante ao uso da função 
sqlite query) seguida por sglite fetch array). 

Defineo tempo máximo de espera do SQLite pela disponibilidade 
de um handle de banco de dados. 


Retorna onúmero de linhas que foram alteradas pelo último 
comando SQL executado, 


Fecha um banco de dados SQLite. 

Obtémo valor de uma coluna da linha corrente do resultado, 
Registra uma função definida pelo usuário (UDF) para o uso 
em comandos SOL. 

Registra uma função do PHP para a utilização em comandos 
SQL. 

Armazena a linha corrente do resultado em um array. Não 
avança o ponteiro do resultado, ao contrário da função 
salite fetch arrayt). 

Retorna a mensagem correspondente a um determinado 
código de erro, 

Adiciona caracteres de escape a uma string, para que ela 
possa ser usada como parâmetro em uma consulta. 


Executa uma consulta (sem resultados) no banco de dados 
especificado. 


Abre um banco de dados SQLite e retorna um objeto 
SQliteDatabase, 


Busca todas aslinhas de um conjunto de resultados (resultset) 
como um array de arrays. 

Obtém a próxima linha do resultado, armazenando-a emum 
array. Os tipos de resultado possíveis são SOLITE NUM 
(chavesnuméricas), SOLITE ASSOC (chaves associativas) 
eSQLITE BOTH(ambos). 


Função 


salte fetch column pes 


sqlte. fetch. object 


sqlite. fetch. single 
sglite fetch. string 
salite field. name 
salte has more 

sqlite has. prev 

salte key 
salite last eror 

sglite last. insert rowid 


sqjite, libencoding 


salte. libversion 
aglite next 

solite num, fields 
salte num 1owS 
salte open 


salte popen 


sqlte prev 
sglite. query 


sqlite rewind 
salte seek 


sqlite single. query 
sqlite udi decode. binary 
sqiite_udf _encode_binary 
sqlite unbulfered query 


salite valid 


Descrição (cont.) 


"Heloma umaray oomos tipos decolunasdeumadeteminada 


tabela. 


Buscaa próxima linha de um conjunto de resultados como um 
objeto. 


Retorna o valor da primeira coluna de um resultado. 
Apelido para afunção sglite fetch. singiel. 

Retorna o nome de um determinado campo do resultado. 
Verifica se ainda existem linhas disponiveis no resultado. 
indicaseháumalinha anteriorà atual. 

Betornao indice da linha corrente. 

Retoma o código do último erro ocorrido no banco de dados. 


Retorna o identificador da linha (rowid) do último registro 
incluido. 


Retorna a codificação utilizada atualmente pela biblioteca 
SQLite. 


Retorna aversão corrente da biblioteca SQLite. 

Avança o ponteiro do resultado para a próximalinha. 
Retoma onúmero de campos existentes em um resultado. 
Retorna número de linhas resultantes de uma consulta. 


Abre um banco de dados SQLite. Se o banco de dados não 
existir, ele será criado. 


Abre um handle persistente para um banco de dados SQLite. 
Se obanco de dados não existir, ele será criado. 


Procura pelalinha anterior à atual no conjunto de resultados. 


Executa uma consulta no banco de dados especificado e 
retornaumponteiroparao resultado. 


Posiciona o ponteiro de um resultado na primeira linha. 


Posiciona o ponteiro de um resultado na linha especificada. As 
linhas iniciam em. 


Executa uma consulta e retorna um array (para uma coluna 
simples) ou somente o valor da primeira linha. 


Decodifica dados binários passados para uma função definida 
pelousuário (UDF). 


Aplicauma codificação binários aos dados fornecidos, para 
queelespossam serretomados deforma seguranas consultas. 


Executa uma consulta emumbancode dados, semarmazenar 
emum buffer as linhas resultantes. 


indica se há mais linhas disponíveis. 


InterBase/Firebird 


Função 
ibase add user 
ibase affected rows 


ibase backup 


ibase blob add 
ibase blob cancel 
base blob close 
ibase. blob create 
base biob echo 
ibase blob get 
ibase blob import 
base blob info 


base blob open 
ibase close 
ibase commit 


ibase connect 
base db info 
base delete user 


base drop db 
ibase ercode 


base errmsg 
ibase execute 
ibase feich assoc 


ibase fetch, object 

ibase fetch row 

base, field info 

base free event handler 
base free query 

base free resul 

base gen id 

ibase maintain db 


ibase modify user 


ibase name result 


Adiciona um usuário ao banco de dados de segurança 
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Descrição 


(somente para IB6 ou posterior). 


Retorna o número de linhas afetadas pela última operação 
executada. 


Iniciaumatarefa de cópia (backup) no gerenciador de serviços 
eretorma imediatamente. 


Adiciona dados em um objeto do tipo BLOB. 

Cancela a criação de um objeto do tipo BLOB, 

Fecha um objeto do tipo BLOB. 

Cria um objeto do tipo BLOB para adicionar dados. 

Exibe no navegador o conteúdo de um objeto BLOB. 
Retorna otamanho, em bytes, de um objeto BLOB aberto, 
Criaumobjeto BLOB, copia um arquivo dentro deleeofecha. 
ano de umobjeto BLOB eoutras informações 
úteis, 

Abre umobjeto BLOB para retornar partes de dados. 
Fecha a conexão com um banco de dados InterBase. 


Contirma uma transação, tornando suas alterações 
permanentes no banco de dados. 


Abre uma conexão com um banco de dados InterBase. 
Obtém as estatísticas de um banco de dados, 


Excluium usuário do banco de dados de segurança. Funciona 
somente para |B6 ou posterior. 


Exclui um banco de dados. 


Retornao código de erro correspondente à última chamada de 
função do InterBase. 


Retorna mensagens de erro, 
Executa uma consulta previamente preparada. 


Obtém uma inha do resultado, armazenando-a emumarray 
associativo, 


Obtém um objeto de um banco de dados InterBase. 
Busca uma linha de um banco de dados InterBase. 
Obtém informações sobre um determinado campo, 
Cancela um handler de eventos registrado anteriormente. 
Libera a memória alocada para uma consulta preparada, 
Liberao conjunto de linhas de um resultado (resul set), 


incrementa o gerador especificado e retorna seu novo valor. 


Executa um comando de manutenção no servidor de bancos 
de dados. 


Altera dados de um usuáriono banco de dados de segurança. 
Funciona somente no IB6 ou posterior. 


Associa um nome ao resultado de uma consulta. 


dbx 
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Função 


ibase num, feias 
ibase num params 


ibase. param. info 
ibase poonnect 
ibase prepare 


base query 
ibase restore 


ibase rolback ret 

ibase, rollback 

ibase server. info 

ibase service attach 
ibase service detach 
ibase set event handler 


ibase timeimi 


ibase trans 
ibase wait event 


dbx close 


dbx compare 
dbx connect 
dbx error 


dbx escape string 
dbx query 


dbx son 


cos de dados 


Descrição (cont.) 


Obtêm onúmero de campos existentes em um resultset. 


Retorna o número de parâmetros existentes emum consulta 
preparada. 


Retornainformações sobre um parâmetro de uma consulta 
preparada. 


Cria uma conexão persistente com um banco de dados 
InterBase. 


Prepara uma consulta para posterior ligação (binding) de 
parâmetros e execução. 


Executa uma consulta em um banco de dados InterBase. 


Iniciaumatarefa de restauração no gerenciador de serviços 
aretoma imediatamente. 


Desfazasalterações feitas porumatransação, sem encerra-la. 
Destaz as alterações feitas por uma transação e a encerra. 
Solicita informações sobre um servidor de banco de dados. 
Conecta ao gerenciador de serviços. 

Desconecta do gerenciador de serviços. 


Registra uma função callback ao ocorrer um determinado 
evento. 


Define o formato das colunas do tipo timestamp, datee time 
retomadas pelas consultas. 


inicia umatransação. 


Suspende a execução do programa até que seja gerado um 
determinado evento pelo banco de dados. 


Fechauma conexão (aberta coma função cbx connecijcom 
umbancodedados. 


Compara duas linhas para fins de ordenação. 
Abre uma conexão com um banco de dados. 


Retorna a mensagem de erro referente à última função 
executada pelo módulo do banco de dados. 


Adiciona caracteres de escape a umtexto, para que ele possa 
serusado em um comando SQL sem gerar erros na sintaxe. 


Envia um comando SQL ao banco de dados e obtém os 
resultados. 


Ordena os registros resultantes de uma consulta utilizando 
uma função de ordenação personalizada. 
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Microsoft SQL Server 


Função 
mssgl_bind 
mssqi_cose 
mssql_connect 


mssql data seek 
mssgl execute 


mesa! fetch array 
mssgl fetch assoc 


mssgl fetch batch 


mssgj fetch, field 
mssgl fetch object 
imasgl fetch row 


mesgl field. Jength 
mssgl feld name 

mesa! field seek 
mesgj field type 
mssgl free resul 
mssql free statement 
mssal get last message 
mssql guid string 

mssgl init 

mesagl min error severity 
mssql min message. severity 
mssgl next result 
mesgl num, fields 

mssgl num rows 

msg! pconnect 

mssql query 

mssgl result 

mssgl rows affected 
mesgl select db 


ouremoto, 

Fecha uma conexão estabelecida com o MS SQL Server. 
Abre uma conexão com um servidor MS SOL Server. 
Move o ponteiro interno das linhas. 


Executa um procedimento armazenado em um servidor MS 
SQL Server, 


Obtém uma linha do resultado como um array. 


Retorna um array associativo contendo a linha corrente do 
conjunto de resultados (result set) especificado. 


Retorna o próximo conjunto de registros armazenados em 
memória. 

Obtém informações sobre um campo. 

Obtém uma linha do resultado como um objeto. 


Obtém uma linha do resultado como um array com indices 
numéricos. 


Obtém o tamanho de um campo. 

Obtém o nome de um campo. 

Faz uma busca no campo pelo offset especificado. 
Obtém o tipo de um campo, 
Libera a memória alocada para armazenar um resultado. 
Libera a memória alocada para execução de um comando. 
Retorna a última mensagem gerada pelo servidor 
Converte um GUID binário de 16 bytes para string. 
Inicializa um procedimento armazenado lócal ou remoto. 
Define a menor severidade para umerro, 

Define a menor severidade para uma mensagem. 

Move o ponteiro interno do resultado para a próxima linha. 
Obtém o número de campos do resultado. 

Obtém o número de linhas do resultado, 

Abre uma conexão persistente com o servidor MS SQL. 
Envia uma consulta ao servidor MS SQL Server. 

Obtém os dados de um resultado. 

Retorna o número de registros afetados por uma operação, 
Seleciona um banco de dados MS SQL Server, 


Oracle 


0€18 


Função 

ora bind 

ora close 

ota columnname 
ora columnsize 
ora columniype 
ora comenit 

ora commitof 
ora commiton 
ora do 


ora, error 
ora errorcode 
ora exes 
ora fetch Into 


ora. tetch 

ora getcolumn 
ora Jogoff 

ora logon 

ora numeals 
ora numrows 


ora open 
ora parse 


ora plogon 
ora roliback 


Função 
ocibindbyname 
ocicancel 
ocicloselob 
ocicoliappend 
ocicallassign 
ocicalassignelem 


Descrição 

Associa uma variável PHP a um parâmetro do Oracle. 
Fecha um cursor. 

Obtém o nome de uma coluna do resultado. 

Obtém otamanho de uma coluna do resultado. 

Obtém otipo de uma coluna do resultado. 

Confirma uma transação. 

Desabilita a confirmação automática (autocommit}. 
Habiltaa confirmação automática (autocommit). 


Combinação das funções ora. parse, ora exece ora. fetch. 
Analisa e executa um comando, elogo após obtéêmaprimeira 
finha do resultado. 


Retorna uma mensagem de erro do Oracle. 
Retoma um código de erro do Oracle. 
Executa um comando analisado em um cursor. 


Obtém uma linha do resultado, armazenando-a no array 
especificado. 


Busca por uma linha a partir de um determinado cursor. 
Obtémos dados de uma determinada coluna. 

Fecha uma conexão com o Oracle. 

Abre uma conexão com o Oracle. 

Retornao número de colunas resultantes. 
Fietormaonúmero delinhas resultantes. 

Abre um cursor. 


Analisa um comando SQL, associando-o a um determinado 
cursor. 


Abre uma conexão persistente com o Oracle. 
Destazumatransação. 


Descrição 


“ associa uma variável PHP a um placeholder do Oracle. 


Cancela a leitura de dados a partir de um cursor. 
Fecha descritor do objeto. 

Adiciona um objeto à coleção. 

Atribui uma coleção a partir de outra já existente. 


Atribui um o valor do elemento à coleção, utilizando o indice 
especificado, 


Função 


ocicoligetelem 
ocicolimax 
ocicolisize 
oeicolitrim 


ocicolumnisnull 
ceicolumnname 
ocicolumnprecision 
ocicotumnscale 
ocicolumnsize 
ocicolumntype 
ocicolurmniyperaw 


ocicommit 
ocidefinebyname 


ociemor 


ociexecute 
ocifetch 
ocifetchinio 
ocifetchstatement 
ocifreecollection 
ocifreecursor 
ocifreedesc 
ocifreestalement 
gciintemaldebug 
ociloadiob 
ocilogoff 
ocilogon 
ocineweollection 
ocinewcursor 
ocinewdescriptor 
ocinlogon 
ocinumcols 
ociparse 
ociplogon 
ociresult 
ocirollback 
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Descrição (cont.) 

Retorna o valor da coleção em um determinado índice, 
Retorna o valor máximo de uma coleção. 
Retoma o tamanho de uma coleção. 


Remove um determinado número de elementos dofinaldeuma 
coleção, 


Testa se uma coluna do resultado é nula (NULL). 
Retorna o nome de uma coluna. 

Retorna a precisão de uma coluna. 

Retorna a escala de uma coluna. 
Retorna o tamanho de uma coluna do resultado. 
Retorna otipo de dados de uma coluna, 


Retornaotipo de uma determinada coluna como um número 
que representa o menor nível de mapeamento de colunasno 
Oracle. 


Confirmaastransações atuais. 


Obtém uma coluna do resultado, armazenando-a em uma 
variável do PHP, 


Retorna um array associativo contendoinformações sobre o 
último erro ocorrido. 


Executa um comando, 

Obtéma próxima linha no buffer de resultados. 

Obtém a próxima linha do resultado como um array. 
Obtém todas as linhas do resultado como um array. 
Exclui um objeto de uma coleção. 

Libera todos os recursos associados a um cursor, 
Exclui o descritor de um objeto extenso, 

Libera todos os recursos associados a um comando, 
Habilita ou desabilita a saida de depuração interna. 
Carrega umobjeto extenso. 

Encerra a conexão com um servidor Oracle. 
Estabelece uma conexão com um servidor Oracle. 
inicializa uma nova coleção. 

Retorna um novo cursor, 

Inicializa um novo descritor de objeto ou de arquivo. 
Estabelece uma nova conexão com um servidor Oracle. 
Retorna onúmero colunas resultantes de um comando. 
Analisa uma consulta e retorna um comando Oracle, 
Estabelece uma conexão persistente com um servidor Oracle, 
Retorna valores das colunas das linhas obtidas, 
Desfaz as transações atuais. 


ODBC 


sêndice B 


Função 


ocirowcount i 
ocisavelob 
ocisavelobfile 
ociservenversion 


ocisetprefeteh 


ocistatementiype 
ociwritelobtofie 
ociwritetemporarylob 


Função 


odbc autocommit | 


odbe_binmode 


odbe close. all 
odbc close 


odio, columnprivileges 


odbe. columns 


odbe. commit 
odbe connect 
odbe cursor 
odbc, data source 
ogbe. do 

odbe. error 

odbc, errormsg 
odbc exec 
odbc. execuie 
odbe fetoh array 
odbe feteh. into 
odbc, feteh. object 
ode fetch row 
odbe, field len 
odbe. field name 
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Descrição (cont.) 

Obtém onúmerode linhas afetadas poruma operação. 
Salva um objeto extenso. 

Salva um arquivo do objeto extenso. 


Retomauma string contendo informações sobre aversão do 
servidor. 


Define onúmerode linhagaseremobtidas no processo de pré- 
busca (prefetehed). 


Retorna o tipo de um comando oci. 
Salva o objeto extenso no arquivo. 
Escreve em um objeto (BLOB) temporário. 


Descrição 


“Haia cauocommi (confimaçãoautomática dasoperações 


realizadas sobre obancode dados): 

Define como serão manipuladas as colunas com dados 
binários. 

Fecha todas as conexões ODBC. 

Fecha uma conexão ODBC. 


Retoma umidentificador de resultado que pode ser usado para 
buscarumalistadecolunaseos privilégios associadosaelas. 


Retorna um identificador de resultado contendo a lista dos 
nomes das colunas existentes nas tabelas especificadas. 


Confirma uma transação ODBC. 

Estabelece umaconexão com umafontede dados (datasource). 
Obtém o nome de um cursor. 

Retorna informações sobre a conexão corrente. 

Apelido para função odbe exec. 

Obtém o código do último erro ocorrido. 

Obtém a mensagem referente ao último erro ocorrido. 
Prepara e executa um comando SAL. 

Executa um comando preparado. 

Obtém uma linha do resultado como um array associativo. 
Obtém uma linha do resultado como um array. 

Obtém uma inha do resultado como um objeto. 

Obtém uma!inhado resultado. 

Obtêmo tamanho (precisão) de um campo. 

Obtém o nome de uma coluna. 


Função 


od fed num Ln 


odbc_field. precision 
odbe_field_scale 
odbc_field_type 
odbe_foreignkeys 


odbe free resul 
odbe. getiypeinto 


odbc longreadien 
odbe nexi resul 
odbc num, fields 
odbc num. rows 
odbe _pconneci 
odbe prepare 
odbc. primarykeys 


odbe procedurecolumns 


odbc. procedures 


odbo result al 
odbo result 

odbe roliback 
odbe setoption 


odbo, specialcolumns 


odbe. statistics 
odbe tableprivileges 
odbe, tables 
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Descrição (cont.) 


Retornaonúmerodeumacoluna. | 
Apelido paraa função odbe, field len. 
Obtém a escala de um campo. 

Obtém a tipo de dado de um campo. 


Retorna lista de chaves estrangeiras na tabela especificada 
ouemoutras tabelas que referenciam sua chave primária. 


Liberaos recursos associados ao resultado. 


Retorna um identificador de resultado contendo informações 
sobreosiipos de dados suportados pela fonte de dados (data 
source). 


Manipulador de colunas do tipo LONG. 

Verifica se estão disponiveis múltiplos resultados. 
Retorna onúmero de colunas existentes em um resultado. 
Retorna onúmero de linhas existentes em um resultado. 
Abre uma conexão persistente com o banco de dados. 
Prepara um comando para execução. 


Retomaum identificador de resultado, que pode serusado para 
buscarosnomes das colunas que compõema chave primaria 
databela. 

Retorna informações sobre parâmetros de um procedimento. 


Retoma um identificador de resultado contendo a lista de 
procedimentos armazenados em uma determinada fonte de 
dados, 

Exibe o resultado como uma tabela HTML. 

Obtémos dados do resultado, 

Desfaz umatransação. 

Ajusta as configurações ODBC. Se algum erro ocorrer, 
retorna FALSE. 

Retoma omelhor conjunto de colunas que identifica de forma 
única uma linha da tabela, ou as colunas que são atualizadas 


automaticamente quando algurmvalornalinha é modificado por 
umatransação. 


Retorna estatisticas sobre uma tabela. 
Listaastabelas e os privilégios associados a cada uma delas. 


Retorna um identificador de resultado contendo a lista dos 
nomes das tabelas armazenadas em uma determinada fonte 
dedados. 


Neste apêndice veremos uma lista de funções que criam e finalizam os diver- 
sos recursos oferecidos pelo PHP. Se você quiser testar se uma variável é con- 
siderada um recurso, basta usar o comando is resource do PHP, que possui a 
seguinte sintaxe: 


is. resource (var) 


Esse comando retorna verdadeiro se a variável definida no parâmetro varé um 
recurso, Para obter o tipo de recurso de uma variável, utilizamos a função 
get. resource type, que possui a seguinte sintaxe: 


get.resource. type (handle) 


Essa função retorna uma string contendo o tipo de recurso que foi passado. 
Será gerado um erro caso o recurso passado for desconhecido. 


A tabela a seguir mostra Os recursos que o PHP oferece, além de apresentar as 
funções que criam e finalizam esses recursos. 


Tipo de recurso Criado por Finalizado por Definição 

aspal aspelne) < Diciondoap 
bzip2 bzopent) bzclosel) Arquivo bzip2 

COM com Joad() ~ Objeto COM 

cpof cpdf..opent) cpdf closet) Documento PDF com biblioteca CPDF 
epdf outine ” > 

cur cur initi) cur closef) Sessão CURL 

dbm dbmopen() dbmelose(} Link para um banco de dados DBM 
cha dba popent) dba, closet) Link para uma base DBA 

dba persistent dba _open{) - Link persistente para uma base DBA 
dbase dbase opent) dbase. closet) Link para uma base Dbase 

dbx (link) dbx connect) dbx closel) Conexão com dbx 

dbx (resultado) dbx query) - Resultado de uma consulta com dbx 


domxmi document - . 


domxmi node - 


domxmi attribute 
xpath context 
xpath object 
fosa (ink) 


fosqi (pink) 


fosg! (resultado) 


{di 
hp 
gd 


gd font 

gd PS font 

gd PS encoding 
GMP integer 
hyperwave link 


hyperwave link persistent 
hyperwave document 


icap 

imap 

imap persistent 

imap chain persistent 
ingres 

ingres persistent 
interbase result 
interbase query 
interbase biob 
interbase link 
interbase link persistent 


interbase transaction 
java 
kiap result 


fbsql change user() 
fosal. connecti) 

fbsal change user() 
fosql. peonnectt) 

fbsgl db query() 
fbsgl list dbs() 

fosgl query) 

fbsgl list, fields!) 

fbsgl list tables() 

fbsgl. tablename() 

fdf open() 

ftp connect) 
imagecreate(), 
imagecreatefromgifl). 
imagecreatefromipeg(), 
imagecreatefrompng(), 
imagecreatefromwbrmpl), 
imagecreatefrormstringt). 
imagecreateiruecolor() 
imageloadfont() 
imagepsloadfont() 


& 
pej 


gmp inti 
hw_connect}) 


hw_pconnect{} 

hw eph, 

hw  docbyanchor(), 

hw. getremote(), 

hw  getremotechildren() 
icap. openi} 

imap opent) 


ingres connect) 
ingres. poonnectl) 
ibase query() 
ibase, preparel) 
ibase connecti) 
ibase pconnecif) 


ibase trans() 


ldap read) 
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fbsal closet) 


fbsgl, free, resultl) 
ft close) 
ip. quit) 


imagedestroy() 


imagepsfreefont() 


ty closel), 
hw, free document) 


tw. deleteobject() 
icap. closet) 
imap close() 


ingres, closet) 


ibase, free result) 
ibase free. query() 


base clusel) 


ibase rollback() 


Idap free resulti) 


Conexão FrontBase 
Conexão persistente FrontBase 


Resultado de uma consulta FrontBase 


Arquivo FDF 
Corrente FTP 


Imagem GD 
Fonte para GD 
Fonte PS para GD 


Número GMP 


Link para um servidor Hyperwave 
Link persistente para um servidor Hyperwave 


Objeto Hyperwave 
Link para um servidor icap 
Link para um servidor IMAP, POP3 


Link persistente para uma base ingresil 
Link para uma base ingrestl 

Resultado Interbase 

Consulta Interbase 


Link para um banco de dados interbase 


Link persistente para um banco de dados 
Interbase 


Transação Interbase 


Busca de resultado idap 


ss 


idap link 


meal 


msq query 


msg link 
msg! link persistent 


masql result 
masqi link 


mssql link persistent 


mysql result 


mysal link 
mysql link persistent 


oci8 statement 
oci8 collection 
oci connection 


ociê descriptor 
oci8 server 

ociê session 

odbe resuit 

odbe link 

odbe link persistent 
velocis link 

velocis result 
OpenSSL key 


OpenSSL X.509 
oracle cursor 
oracle link 


oracle link persistent 


pdf image 


pdf outline 
pof document 
posa! link 


idap connect), 


idap, search() 
meal openl, 
meal popenf) 
msal query) 


sal connect) 
msa pconnectQ 


mssql queryQ 
mesa! connect 


masal peonnectQ 


mysql db. query), 
mysql list dbsQ, 
mysal list fields}, 
mysql _list_tables(). 
mysql_query(} 
mysol connecti) 
mysqi_pconnect() 


ocmewdescriptor() 


ocilogon(}, 
eciplogont), 
ociniogenth 


odbe prepare) 
odbe connect} 
odbe connect) 


openssl get privatekey(), 
openssl get publickey() 
openssl x508 reado) 

ora opent) 

ora logont) 


ora. plogonf) 


pol open imagel, 
pdf open image. fiel), 


idap closel) 


meal closel) 
msg! free result), 
msg! free result) 
mal close() 


mssgl free resulQ 
masgl closel 


mysql free result) 
mysql ciosel) 


ocifreestatementO 
ocitogoft() 


odbe free result) 
odbe closel) 


openssi free key) 
openssl x509. free() 
ora, close) 

ora logofff) 


pdf open memory. image() pdf close, imagel) 


pof new() 
pg..connectt) 


pdf closet), pdf. delete() 


pq..close() 


Conexão idap 


Link para o servidor de calendário 


Resultado mSQL 
Link para um banco de dados mSQL 
Link persistente para um banco de dados mSQL 


Resultado do Microsft SQL Server 


Link para um banco de dados Microsft SQL 
Server 


Link persistente para um banco de dados 
Microsft SQL Server 


Resultado do MySQL. 
Link para um banco de dados MySQL 


Link persistente para um banco de dados 
MySQL 


Cursor do Oracle 


Link para um banco de dados Oracle 


Resultado ODBC 
Link para um banco de dados ODBC 
Link persistente para um banco de dados ODBC 


Chave OpenSSL. 

Chave pública 

Cursor do oracle 

Link para um banco de dados oracle 


Link persistente para um banco de dados oracie 


imagem em um arquivo PDF 


documento PDF 
Link para um banco de dados PostGreSQL 


apr 


Tipo de recurso 


pasa! link persistent 


posal result 
pasal large object 


pasql string 
printer 
printer pen 
printer font 
printer brush 
pspell 


pspell config 

Sablotron XSLT 

shmop 

sockets file descriptor set 
sockets lo vector 

dir 

file 

pipe 

socket 

sybase-db link 


sybase-db link persistent 


sybase-db result 
sybase-et link 


sybase-ct link persistent 
sybase-ct result 


sysvsem 
sysvshm 
wddx 
xmi 

zib 


Criado por 
pg. peonnectt) 


pa query) 
pggetlastoidi), 
pa.oimport(), 
pg Joimportl) 


pspell newl). 
pspeli_new_configi), 
pspeli new, personal() 
pspell config. createl) 
«sit, create() 

shm open) 

sovketl 

dirt) 

fopent) 

popent) 

fsackopent) 

sybase connect() 


sybase. pconnectt) 


sybase. query() 
sybase, connect() 


sybase pconnectt) 
sybase query) 


sem. get) 

shm attach() 

wddx packet, start() 
ximl parser createl) 
gropent) 
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Finalizado por 


pg. freeresultl) 


pg. Jocloset) 


xsit feel) 
shm close() 
close() 


closedir() 
iclose() 
pelose(} 
fclose() 

sybase closet) 


sybase free resulti) 
sybase close() 


sybase, free. result() 


sem release!) 

shm detach() 
wddx packet end() 
xml, parser. free() 
gzctosel) 


Definição (cont.) 


Link persistente para um banco de dados 
PostGreSQL 


Resultado do PostGreSQL 


Objeto extenso do PostGreSQL 


Dicionário pspell 
Configuração papel! 
Parser XSLT 


Socket 


Manipulador de Diretório 
Manipulador de arquivo 
Manipulador de processo 
Manipulador de socket 


Link para um banco de dados Sybase usando 
a biblioteca DB 


Link persistente para um banco de dados 
Sybase usando a biblioteca DB 


Resultado do Sybase usando a biblioteca DB 


Link para um banco de dados Sybase usando 
a biblioteca CT 


Link persistente para um banco de dados 
Sybase usando a biblioteca CT 


Resultado do Sybase usando a biblioteca CT 


Semaforo do System V 

Memória compartilhada do System V 
Pacote WDDX 

Parser XML 

Arquivo comprimido do tipo gz 


Apêndice D 


Links interessantes 


Acessando os links apresentados a seguir você poderá se aprofundar ainda 
mais no estudo da linguagem PHP e de outras tecnologias. São sites que ofere- 
cem tutoriais, scripts gratuitos, documentação detalhada e diversas outras fer- 
ramentas úteis para o desenvolvimento de sites dinâmicos e interativos. 


Site oficial do PHP 
°. hip://www.php.net 


Neste site você encontra toda a documentação e o código do PHP, além 
das novidades e as versões mais recentes para download, 


Scripts, programas e tutoriais PHP 


Apresenta uma lista de editores que você pode usar para editar seus pro- 
gramas em PHP, 


* - hitp;//phpclassesupperdesign.com/ 
Um repositório de classes em PHP, 


Apresenta muitos exemplos de scripts e funções úteis. Possui um bom me- 
canismo de busca para você encontrar as informações facilmente, 
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Programas e tutoriais para o PHP. 


hrp://www weberdev.com/ 


Apresenta artigos, fóruns, tutoriais, scripts etc, 


Contém diversos artigos sobre PHP. 


Catálogos de links PHP 


& 


Apresenta grande diversidade de recursos PHP, incluindo documentação, 
scripts completos e funções, O site é todo dividido em categorias € possui 
uma ferramenta de busca para que você encontre facilmente as informa- 
ções desejadas, 


Outros links 


Site oficial do MySQL. 
http://www postgresgLorg/ 
Site oficial do PostgreSQL. 
http://www. apache.org 


Site oficial do Apache. 


Site oficial da Zend Technologies. 


Índice remissivo 


Simbolos 
l= 52 


$ 37 
$_COOKIE 181 
$_GET 109 
$_POST 109 
$ SESSION 190 
$GLOBALS 38 
% 48 

%= 53 

&& 54 

&= 53 

(array) 41 
(float) 41 

(int) 41 
(object) 41 
real) 41 
(string) 41 


alfanuméricos 32 
ALTER TABLE 142 
AND 54 

Apache 24 
arquivos 197 
Arrays 44 

ASP 27 

aspas duplas 34 
aspas invertidas 35 
aspas simples 32 
atribuição 48 
Autenticação 186 
AUTH TYPE 127 
AVG 150 


B 

Bee 219 
bigint 133 
bit 133, 134 
blob 135 
bool 133, 134 
boolean 134 
box 133 
break 72 
BSD 129 
bytea 133 


C 

case 63 

Ce 219 

char 133 

chave primária 183 
checkbox 105 
chmod 203 

cidr 133 

circle 133 


class 88 empty 55 
classe 47, 87 endif 62 
classes 75 enum 135 
comandos condicionais 59 Errors-To 220 
comandos de repetição 59 Escopo 38 
Comments 219 expressão 50, 57 
Constantes 36 extensão 27 
constraints 129 a 
construtor 93 
Content-Transfer-Encoding 219 FALSE 37 
Content-Type 218, 219 fatorial 86 
CONTENT_LENGHT 127 fclose 200 
CONTENT_TYPE 127 feof 205 
continue 74 fgets 201 
Conversão 40 file 105 
conversores 40 file_exists 205 
cookies 180 file get contents 205 
copy 204 filesize 207 
COUNT 149 float 134 
CPF 80 fioat4 133 
create database 132 fioat8 133 
createdb 131 fopen 198 
CURRVAL 157 for 68 

foreach 71 
D form 107, 108 
date 133 formulário 103, 112 
datetime 134 fread 200 
decimal 134 Frontpage 21 
default 65 fseek 208 
define 36 ftell 208 
describe 137 FTP 23 
destrutor 94 Funções 75 
DISTINCT 149 funções recursivas 85 
do.. while 67 fwrite 201 
double 134 G 
DROP TABLE 143 

GATEWAY INTERFACE 127 
E GET 107 
e-mails 213 getenv 125 
E ERROR 37 global 38 
E NOTICE 37 GPL 129 
E PARSE 37 GROUP BY 151 
E WVARNING 37 H 
echo 26 
else 60 HAVING 151 
elseif 60 hidden 104, 116 


hospedagem 23 


Índice remissvo 

HTML 27, 103 
htmispecialchars 110 
HTTP ACCEPT 127 
HTTP USER AGENT 127 


l 

if 60 

image 105 
implements 92 
includes 97 
incremento 58 
indice 44 

inet 133 

input 104 

int 133, 134 
int2 134 

intá 133 

int 133 
interfaces 92 
interpolação 30, 41 
interval 133 
INTO 155 

IP 126 


L 

LIKE 147 

LIMIT 154 

ine 133 

inux 24 

login 183, 194 
logout 188, 195 
ongblob 135 
ongtext 135 
seg 133 


M 
acaddr 133 
mail 214 

mail headers 219 
maiúsculas 38 
MAX 150 
maxlength 105 
mediumint 134 
mediumtexi 135 
métodos 92 
MIME 219 

MIN 150 


minúsculas 38 

move. uploaded file 210 
MySQL 24, 129 

mysql affected rows 164 
mysql connect 159 

mysql fetch. array 164, 167 
mysql fetch object 154 
mysql fetch row 164, 167 
mysql field name 164 
mysql num. feids 164 
mysql num rows 164, 165 
mysql query 162 

mysql result 164, 165 
mysql select db 160 
mysqli 160 


N 

NEXTVAL 157 
NOT NULL 139 
NULL 140 
numeric 133 
numéricas 44 
numéricos 31 


O 

objeto 88 

Objetos 47 

OP 90 

operadores 47 
Operadores aritméticos 48 
Operadores binários 50 
Operadores de atribuição 52 
Operadores lógicos 54 
OR 54 

orientada a objetos 90 


P 

parâmetros 77 
password 104 

path 133 

PATH INFO 127 
PATH TRANSLATED 127 
pg affected rows 164 
pq. connect 161 

pg fetch array 164 
pg. fetch object 164 
pq. fetch row 164 


rr rimam mir a ci 


pq. field name 164 
pg num fields 164 
pg. num rows 164 
pg. query 163 

pg result 164 
PHP 19 

PHP OS 37 

PHP VERSION 37 
point 133 

polygon 133 
pós-incremento 48 
POST 108 
PostgreSQL 24, 129 
prê-incremento 48 
precedência 57 
Priority 220 

psgl 131 


Q 
QUERY. STRING 127 


R 

radio 105 

real 133 

Received 220 

recursivas 85 

referência 82 

REMOTE ADDR 126, 127 
REMOTE HOST 127 
REMOTE IDENT 127 
REMOTE USER 127 
Reply-To 217, 220 
REQUEST_METHOD 127 
require 101 

reset 105 

return 77 

rmdir 211 


5 

SCRIPT_NAME 127 
SELECT 144 

select 105 

Sender 220 
sendmail from 216 
sendmail path 215 
sequências 156 
serial 134 


SERVER NAME 127 
SERVER PORT 127 
SERVER. PROTOCOL 127 
SERVER SOFTWARE 127 
session.auto start 192 
session.bug compat 42 193 
session bug compat warm 193 
session.cache expire 193 
session.cache. limiter 193 
session.cockie domain 193 
session.cookie, lifetime 193 
session.cookie path 193 
session.cookie secure 193 
session.entropy file 193 
session.entropy length 193 
session.gc maxlifetime 193 
session.ge. probability 193 
session.name 192 
session.referer check 193 
session. save handler 192 
session.save path 192 
session.serialize handler 192 
session.use cookies 193 
session.use only cookies 193 
session.use trans sid 193 
session destroy 195 

session register 190 

session start 190 

session unset 195 

sessões 190 

set 135 

setcovkie 180 

SETVAL 157 

SGBDs 129 

show 137 

SID 190 

sizeof 74 

smallint 134 

SMTP 216 

SQL 132, 159 

SQLite 130, 172 

salte changes 175 

salite close 175 

salite fetch array 175 
salte num fields 175 
salite num rows 175 


Índice remissivo 269 


sglite open 175 X 

sglite query 175 X-Confirm-Reading-To 220 
static 95 XOR 54 

stored procedures 129 

strings 44 Y 

stripslashes 111 year 135 

strien 114 Z 

strstr 114 A 

subclasses 90 Zend Engine 90 
Subject 220 
submit 105 
SUM 149 
switch 63 


T 
tempnam 211 

text 134 

textarea 105 

time 134 

timestamp 134, 135 
timestampiz 134 
timetz 134 

tinyint 134 

tmpfile 212 
transações 129 
triggers 129 

TRUE 37 


U 

unlink 212 

unset 194 

url rewritertags 193 
uridecode 112 
urlencode 112 


V 

varbit 133 

varchar 134 

variáveis 37 

variáveis de ambiente 125 
velocidade 27 

views 129 


W 
while 65 
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Web Interativa com Ajax e PHP 


Autor: Juliano Niederauer 
ISBN: 85-7522-126-6 


PHP para quem conhece PHP 


Autor: Juliano Niederauer 
ISBN: 85-7522-044-6 


Segurança em PHP 


Autor: Márcio Pessoa 
ISBN: 85-7522-140-2 


PHP PROFISSIONAL 


Autor: Alexandre Altair de Melo e 
Mauricio G. F Nascimento 
ISBN: 85-7522-141-9 


PHP-GTK — 2º Edição 


Autor: Pablo Dall'Oglio 
ISBN: 85-7522-110-5 


Frameworks para Desenvolvimento em PHP 


Autor: Elton Luís Minetto 
ISBN: 85-7522-124-2 
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DSPntiothendo Websites com PHP A teto técnicas de 
programação fundamentais paa o desenvolvimento de sites dinâmicos 
e interativos. Você aprenderá a desenvolver sites com uma linguagem 
utilizada em mais de 1o milhões de sites no mundo inteiro. O livro abrange 


desde noções | de progr ão até a criação e manutenção 
de bancos de dad: , mostrando: p são feitas inclusões, exclusões, 
alterações e consultas a tabelas de uma base de dados. O autor apre- 
senta diversos exemplos de programas para facilitar a compreensão da 
linguagem. gpa obra, você irá encontrar os seguintes assuntos: 


@ Oqueé PHP e quais são suas características; 


e Conceitos básicos e avançados de programação em PHP; 
e Como manipular diversos tipos de dados com o PHP; 


“e Comandos PHP em conjunto com tags HTML; 


° Utilização de includes para aumentar o dinamismo de seu site; 
e Como tratar os dados enviados por um formulário HTML; 

e Utilidade das variáveis de ambiente no PHP; 

e Criação de banco de dados em MySQL, PostgreSQL ou SQLite; 
e Comandos SQL para acessar o banco de dados via PHP; 

e Como criar um sistema de username/password para seu site; 

e Utilização de cookies e sessões; 

e Leitura e gravação de dados em arquivos-texto; 


e Como enviar e-mails pelo PHP. 


e SOBRE O AUTOR 


Juliano Niederauer (www.niederauer.com.br) é graduado em Ciência 

da Computação e pós-graduado em Gestão Empresarial, com ênfase 

em Tecnologia Aplicada a Negócios. Possui larga experiência no 
desenvolvimento de aplicações para a Web. Já criou sites de sucesso, 
como o Só Matemática (www.somatematica.com.br), o maior portal 
matemático do mundo. Atualmente desenvolve soluções para 
dispositivos móveis, como palmtops, além de ministrar cursos sobre PHP. 
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